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This manual describes the features of the UNIX System. It provides nei- 
ther a general overview of the UNIX System nor details of the implementation 
of the system. Commands that constitute the basic software running on your 
computer are described. 

The manual is divided into three sections: 

■ 1 - System Commands, System Maintenance Commands, and Applica- 
tion Programs 

■ 7 - Special Files 

■ Index to Packages. 

Throughout this volume each reference of the form name{lM), name{7), or 
followed by a (1), (IC), or (IG), refers to entries in this manual. The numbers 
following the command are intended for easy cross-reference. (Section 1 com- 
mands appropriate for use by programmers are located in the Programmer's 
Reference Manual) All other references to entries of the form name{N), where 
N is a number [(2), (3), (4), or (5)] possibly followed by a letter, refer to entry 
name in Section N of the Programmer's Reference Manual. 

Each entry in the " Commands " section appears under a single name 
shown at the upper comers of its page(s). Entries are alphabetized, with the 
exception of the intro(l) entry, which is first. Entries may consist of more 
than one page. Some entries may describe several routines, commands, etc. 
In such cases, the entry appears only once, alphabetized under its "primary" 
name, the name that appears at the upper comers of the page. An example of 
such an entry is mount(lM), which also describes the umount command. 
The "secondary" commands are listed directly below their associated primary 
command. 

Section 1 {System Commands, System Maintenance Commands and Applica- 
tion Programs) contains commands and programs that are: 

■ Used in administering a UNIX System. 

■ Invoked directly by the user or by command language procedures, as 
opposed to subroutines, which are called by the user's programs. 
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Commands generally reside in the directory /bin (for binary programs). 
In addition, some programs reside in /usr/bin. These directories are searched 
automatically by the command interpreter called the shell. The shell will 
search the path in your .profile. Make sure you have set this path in your 
.profile file. UNIX Systems running on your computer also have a directory 
called /usr/lbin, containing local commands. 

The following sub-classes are in this section: 

■ 1 - General-purpose Commands 

■ IC - Communications Commands 

■ IG - Graphics Commands 

■ IM - Maintenance Commands 

Each entry in the " Commands " section appears under a single name 
shown at the upper corners of its page(s). 

Section 7 {Special Files) discusses the characteristics of system files that 
refer to input/output devices. The names in this section generally refer to 
device names for the hardware, rather than to the names of the special files 
themselves. 

Index to Packages. The utilities packages represented in this section are: 

1. Base System 

2. Editing Package 

3. Remote Terminal Package 

The Security Administration Utilities Package is expressly provided for 
U. S. customers. 

All entries are presented using the following format (though some of these 
headings might not appear in every entry): 

■ NAME gives the primary name [and secondary name(s), as the case 
may be] and briefly states its purpose. 

■ SYNOPSIS summarizes the usage of the program being described. A 
few explanatory conventions are used, particularly in Section IM and 
the SYNOPSIS: 
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□ Boldface strings are literals and are to be typed just as they 
appear. 

□ Italic strings usually represent substitutable argument prototypes 
and command names found elsewhere in the manual. (They are 
underlined in the typed version of the entries.) 

□ Square brackets [ ] around an argument prototype indicate that the 
argument is optional. When an argument prototype is given as 
"name" or "file," it always refers to a. file name. 

□ Ellipses . . . are used to show that the previous argument prototype 
may be repeated. 

□ A final convention is used by the commands themselves. An 
argument beginning with a minus (-), plus (+), or an equal sign (=) 
is often taken to be some sort of flag argument, even if it appears in 
a position where a file name could appear. Therefore, it is unwise 
to have files whose names begin with -, +, or =. 

■ DESCRIPTION discusses how to use these commands. 

■ EXAMPLE(S) gives example(s) of usage, where appropriate. 

■ FILES contains the file names that are referenced by the program. 

■ EXIT CODES discusses values set when the command terminates. The 
value set is available in the shell environment variable [see sh(l)]. 

■ NOTES gives information that may be helpful under the particular cir- 
cumstances described. 

■ SEE ALSO offers pointers to related information. 

■ DIAGNOSTICS discusses the error messages that may be produced. 
Messages that are intended to be self-explanatory are not listed. 

■ WARNINGS discusses the limits or boundaries of the respective com- 
mands. 

■ BUGS lists known faults in software that have not been rectified. 
Occasionally, a suggested short-term remedy is also described. 
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Preceding Section 1 are a " Table of Contents " (listing both primary and 
secondary command entries) and a "Permuted Index." Each line of the 
"Table of Contents" lists an abstract of the command. The "Permuted 
Index" is used by searching the middle column for a key word or phrase. 
The right column will then contain the name of the manual page that contains 
the command. The left column contains additional useful information about 
the command. 



How to Get Started 

This discussion provides the basic information you need to get started on 
the UNIX System: how to log in and log out, how to communicate through 
your terminal, and how to run a program. (See the User's Guide for a more 
complete introduction to the system.) 

Logging In 

You must connect to the UNIX System from the console or a full-duplex 
ASCII terminal. You must also have a valid login id, which may be obtained 
[together with how to access your UNIX System] from the administrator of 
your system. Common terminal speeds are 120, 240, 480, and 960 characters 
per second (1200, 2400, 4800, and 9600 baud). Some UNIX Systems have dif- 
ferent ways of accessing each available terminal speed, while other systems 
offer several speeds through a common access method. In the latter case, 
there is one "preferred" speed; if you access it from a terminal set to a dif- 
ferent speed, you will be greeted by a string of meaningless characters (the 
login: message at the wrong speed). Keep hitting the "break," "interrupt," 
or "attention" key until the login: message appears. 

Most terminals have a speed switch that should be set to the appropriate 
speed and a half-/full-duplex switch that should be set to full-duplex. When 
a connection has been established, the system types login:. You respond by 
typing your login id followed by the "return" key. If you have a password, 
the system asks for it but will not print, or " echo, " it on the terminal. After 
you have logged in, the "return," "new-line," and "line-feed" keys all have 
equivalent meanings. 

Make sure you type your login name in lowercase letters. Typing upper- 
case letters causes the UNIX System to assume that your terminal can generate 
only uppercase letters and will treat all letters as uppercase for the remainder 
of your login session. 
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When you log in, a message-of-the-day may greet you before you receive 
your prompt. For more information, consult login{l), which discusses the 
login sequence in more detail, and stty{l), which tells you how to describe 
your terminal to the system, profile (4) (in the Programmer's Reference Manual) 
explains how to accomplish this last task automatically every time you log in. 

Logging Out 

There are two ways to log out: 

■ If you've dialed in, you can simply hang up the phone. 

■ You can log out by typing an end-of-file indication (ASCII EOT charac- 
ter, usually typed as "CTRL-D") to the shell. The shell will terminate, 
and the login: message will appear again. 

How to Communicate Tiirough Your Terminal 

When you type to the UNIX System, your individual characters are being 
gathered and temporarily saved. Although they are echoed back to you, these 
characters will not be given to a program until you type a "return" (or 
"new-line") as described above in "Logging In." 

UNIX System terminal input/output is full duplex. It has full read-ahead, 
which means that you can type at any time, even while a program is display- 
ing information for you. Of course, if you type during output, your input 
characters will have output characters interspersed among them. In any case, 
whatever you type will be saved and interpreted in the correct sequence. 
There is a limit to the amount of read-ahead, but it is generous and not likely 
to be exceeded. 

The character @ cancels all the characters typed before it on a line, effec- 
tively deleting the line. (@ is called the line kill character.) The character # 
erases the last character typed. Successive uses of # will erase characters back 
to, but not beyond, the beginning of the line; @ and # can be typed as them- 
selves by preceding them with \ (thus, to erase a \, you need two #s). These 
default erase and line kill characters can be changed; see stty{l), 

CTRL-S (also known as the ASCII DC3 character) is typed by pressing the 
control key and the alphabetic s simultaneously and is used to stop output 
temporarily. It is useful with CRT terminals to prevent output from disappear- 
ing before it can be read. Output is resumed when a CTRL-Q (also known as 
DCl) is typed. Thus, if you had typed cat yourfile and the contents of your- 
file were passing by on the screen more rapidly than you could read it, you 
would type CTRL-S to freeze the output. Typing CTRL-Q would allow the 
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output to resume its rapid pace. The CTRL-S and CTRL-Q characters are not 
passed to any other program when used in this manner. 

The ASCII DEL (a.k.a. "rubout") character is not passed to programs but 
instead generates an interrupt signal, just like the "break," "interrupt," or 
"attention" signal. This signal generally causes whatever program you are 
running to terminate. It is typically used to stop a long printout that you do 
not want. Programs, however, can arrange either to ignore this signal alto- 
gether or to be notified and take a specific action when it happens (instead of 
being terminated). The editor ed{l), for example, catches interrupts and stops 
what it is doing, instead of terminating, so an interrupt can be used to halt an 
editor printout without losing the file being edited. 

Besides adapting to the speed of the terminal, the UNIX System tries to be 
intelligent as to whether you have a terminal with the "new-line" function, or 
whether it must be simulated with a "carriage-return" and "line-feed" pair. 
In the latter case, all input "carriage-return" characters are changed to "line- 
feed" characters (the standard line delimiter), and a "carriage-return" and 
"line-feed" pair is echoed to the terminal. 

Tab characters are used freely in UNIX System source programs. If your 
terminal does not have the tab function, you can arrange to have tab charac- 
ters changed into spaces during output, and echoed as spaces during input. 
Again, the stty(l) command will set or reset this mode. The system assumes 
that tabs are set every eight character positions. The tabs{l) command will set 
tab stops on your terminal, if that is possible. 



How to Run a Program 

When you have successfully logged into the UNIX System, a program 
called the shell is communicating with your terminal. The shell reads each 
line you type, splits the line into a command name and its arguments, and 
executes the command. A command is simply an executable program. Nor- 
mally, the shell looks first in your current directory (see " The Current Direc- 
tory" below) for a program with the given name, and if none is there, then in 
system directories, such as /bin and /usr/bin. There is nothing special about 
system-provided commands except that they are kept in directories where the 
shell can find them. You can also keep commands in your own directories 
and instruct the shell to find them there. See the manual entry for s/z(l), 
under the sub-heading " Parameter Substitution, " for the discussion of the 
$PATH shell environment variable. 
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The command name is the first word on an input line to the shell; the 
command and its arguments are separated from one another by space or tab 
characters. 

When a program terminates, the shell will ordinarily regain control and 
give you back your prompt to indicate that it is ready for another command. 
The shell has many other capabilities, which are described in detail in sft(l). 

The Current Directory 

The UNIX System has a file system arranged in a hierarchy of directories. 
When you received your login id, the system administrator also created a 
directory for you (ordinarily with the same name as your login id, and known 
as your login or home directory). When you log in, that directory becomes 
your current or working directory, and any file name you type is, by default, 
assumed to be in that directory. Because you are the owner of this directory, 
you have full permissions to read, write, alter, or remove its contents. Permis- 
sions to enter or modify other directories and files will have been granted or 
denied to you by their respective owners or by the system administrator. To 
change the current directory, use cd(l). 

Path Names 

To refer to files or directories not in the current directory, you must use a 
path name. Full path names begin with /, which is the name of the root 
directory of the whole file system. After the slash comes the name of each 
directory containing the next subdirectory (followed by a /), until finally the 
file or directory name is reached (e.g., /usr/ae/filex refers to file filex in 
directory ae, while ae is itself a subdirectory of usr, and usr is a subdirectory 
of the root directory). Use pwd{l) to print the full path name of the directory 
you are working in. See intro{2) in the Programmer's Reference Manual for a 
formal definition of path name. 

If your current directory contains subdirectories, the path names of their 
respective files begin with the name of the corresponding subdirectory 
(without a prefixed /). A path name may be used anywhere a file name is 
required. 
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Introduction 

Important commands that affect files are cp{l), mv (see cp(l)), and rm(\), 
which respectively copy, move (i.e., rename), and remove files. To find out 
the status of files or directories, use /s(l). Use mkdir{\) for making directories 
and rmdir [see rm{l)] for removing them. 

Text Entry and Display 

Almost all text is entered through an editor. Common examples of UNIX 
System editors are ed{\) and vi{\). The commands most often used to print 
text on a terminal are cat{l), pr(l), and pg{\). The cat{\) command displays 
the contents of ASCII text files on the terminal, with no processing at all. The 
pr(l) command paginates the text, supplies headings, and has a facility for 
multi-column output. The pg(l) command displays text in successive portions 
no larger than your terminal screen. 

Communicating witii Others 

Certain commands provide inter-user communication. Even if you do not 
plan to use them, it would be well to learn something about them because 
someone else may try to contact you. mail{\) or mailx{\) will leave a message 
whose presence will be announced to another user when he or she next logs 
in and at periodic intervals during the session. To communicate with another 
user currently logged in, write{\) is used. The corresponding entries in this 
manual also suggest how to respond to these two commands if you are their 
target. 

See Chapter 8 of the Operations /System Administration Guide for more 
information on communicating with others. 
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NAME 

intro - introduction to commands and application programs 
DESCRIPTION 

This section describes, in alphabetical order, commands (includmg system 
maintenance commands) available for your computer. The commands in 
this section should be used along with those listed in Sections 1, 2, 3, 4, and 
5 of the Programmer's Reference Manual. References of the form name(l), 
name{2), name(3), name{4), and name(5) refer to entries in the above manual. 
References of the form name{\), name{\M), name{\C), name{\G\ name{7), or 
name{S) refer to entries in this manual. Certain distinctions of purpose are 
made in the headings. 

The following Utility packages are delivered with the computer: 

Base System 

Editing Package 

Extended Terminal Interface 

Security Administration Package 

2 Kilobyte File System Utility Package 

Network Support Utilities Package 

Remote File Sharing Utilities Package 

Manual Page Command Syntax 

Unless otherwise noted, commands described in the SYNOPSIS section of a 
manual page accept options and other arguments according to the following 
syntax and should be interpreted as explained below. 

name [-option...] [cmdarg...] 
where: 

[ ] Surround an option or cmdarg that is not required. 

Indicates multiple occurrences of the option or cmdarg. 

name The name of an executable file. 

option (Always preceded by a "-".) 

noargletter ... or, 
argletter optarg[,...] 

noargletter A single letter representing an option v^dthout an option- 
argument. Note that more than one noargletter option can be 
grouped after one (Rule 5 in the following text). 

argletter A single letter representing an option requiring an option- 
argument. 

optarg An option-argument (character string) satisfying a preceding 

argletter. Note that groups of optargs following an argletter 
must be separated by commas or separated by white space 
and quoted (Rule 8 below). 

cmdarg Path name (or other command argument) not beginning with 

or by itself indicating the standard input. 
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Command Syntax Standard: Rules 

These command syntax rules are not followed by all current commands, but 
all new commands use them. getopts{l) should be used by all shell pro- 
cedures to parse positional parameters and to check for legal options. It 
supports Rules 3-10 below. The enforcement of the other rules must be 
done by the command itself. 

1. Command names {name above) must be between two and nine 
characters long. 

2. Command names must include only lowercase letters and 
digits. 

3. Option names (option above) must be one character long. 

4. All options must be preceded by 

5. Options with no arguments may be grouped after a single 

6. The first option-argument (optarg above) following an option 
must be preceded by white space. 

7. Option-arguments cannot be optional. 

8. Groups of option-arguments following an option must either 
be separated by commas or separated by white space and 
quoted (e.g., -o xxx,z,yyor -o "xxx z yy"). 

9. All options must precede operands (cmdarg above) on the 
command line. 

10. " — " may be used to indicate the end of the options. 

11. The order of the options relative to one another should not 
matter. 

12. The relative order of the operands {cmdarg above) may affect 
their significance in ways determined by the command with 
which they appear. 

13. preceded and followed by white space should only be 
used to mean standard input. 

SEE ALSO 

getopts(l), exit(2). 

wait(2), getopt(3C) in the Programmer's Reference Manual, 
How to Get Started at the front of this document. 
DIAGNOSTICS 

Upon termination each command returns two bytes of status, one supplied 
by the system and giving the cause for termination and (in the case of "nor- 
mal" termination) one supplied by the program [see wait{2) and exit{l)]. 
The former byte is for normal termination; the latter is customarily for 
successful execution and non-zero to indicate troubles such as erroneous 
parameters or bad or inaccessible data. It is called variously "exit code," 
"exit status," or "return code" and is described only where special conven- 
tions are involved. 
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BUGS 

Regrettably, not all commands adhere to the aforementioned syntax. 
WARNINGS 

Some commands produce unexpected results when processmg files contam- 
ing null characters. These commands often treat text input lines as strings 
and therefore become confused upon encountering a null character (the 
string terminator) within a line. 
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NAME 

300, 300s - handle special functions of DASI 300 and 300s terminals 

SYNOPSIS 

300 [ +12 ] [ -n ] [ -dt,l,c ] 

300s [ +12 ] [ -n ] [ -dt,l,c ] 

DESCRIPTION 

The 300 command supports special functions and optimizes the use of the 
DASI 300 (GSI 300 or DTC 300) terminal; 300s performs the same functions 
for the DASI 300s (GSI 300s or DTC 300s) terminal. It converts half-line for- 
ward, half-line reverse, and full-line reverse motions to the correct vertical 
motions. In the following discussion of the 300 command, it should be 
noted that unless your system contains the DOCUMENTER'S WORKBENCH 
Software, references to certain commands (e.g., nroff, neqn, eqn, etc.) will 
not work. It also attempts to draw Greek letters and other special symbols. 
It permits convenient use of 12-pitch text. It also reduces printing time 5 to 
70%. The 300 command can be used to print equations neatly, in the 
sequence: 

neqn file . . . | nroff | 300 

WARNING: if your terminal has a PLOT switch, make sure it is turned on 
before 300 is used. 

The behavior of 300 can be modified by the optional flag arguments to han- 
dle 12-pitch text, fractional line spacings, messages, and delays. 

+12 permits use of 12-pitch, 6 lines/inch text. DASI 300 terminals nor- 
mally allow only two combinations: 10-pitch, 6 lines/inch, or 12- 
pitch, 8 lines/inch. To obtain the 12-pitch, 6 lines per inch com- 
bination, the user should turn the PITCH switch to 12, and use the 
+12 option. 

-n controls the size of half-line spacing. A half-line is, by default, 

equal to 4 vertical plot increments. Because each increment 
equals 1/48 of an inch, a 10-pitch line-feed requires 8 increments, 
while a 12-pitch line-feed needs only 6. The first digit of n over- 
rides the default value, thus allowing for individual taste in the 
appearance of subscripts and superscripts. For example, nroff 
half-lines could be made to act as quarter-lines by using -2. The 
user could also obtain appropriate half-lines for 12-pitch, 8 
lines/inch mode by using the option -3 alone, having set the 
PITCH switch to 12-pitch. 

-df,/,c controls delay factors. The default setting is -d3,90,30. DASI 300 
terminals sometimes produce peculiar output when faced with 
very long lines, too many tab characters, or long strings of blank- 
less, non-identical characters. One null (delay) character is 
inserted in a line for every set of t tabs, and for every contiguous 
string of c non-blank, non-tab characters. If a line is longer than / 
bytes, l+(total length)/20 nulls are inserted at the end of that 
line. Items can be omitted from the end of the list, implying use 
of the default values. Also, a value of zero for t (c) results in two 



- 1 - 



300(1) 



(Extended Tenninal Interface) 



300(1) 



null bytes per tab (character). The former may be needed for C 
programs, the latter for files like /etc/passwd. Because terminal 
behavior varies according to the specific characters printed and 
the load on a system, the user may have to experiment with these 
values to get correct output. The -d option exists only as a last 
resort for those few cases that do not otherwise print properly. 
For example, the file /etc/passwd may be printed using -d3,30,5. 
The value -dO,! is a good one to use for C programs that have 
many levels of indentation. 

Note that the delay control interacts heavily with the prevailing 
carriage return and line-feed delays. The stty{l) modes nlO cr2 or 
nlO cr3 are recommended for most uses. 
The 300 command can be used with the nroff -s flag or .rd requests, when 
it is necessary to insert paper manually or change fonts in the middle of a 
document. Instead of hitting the return key in these cases, you must use 
the line-feed key to get any response. 

In many (but not all) cases, the following sequences are equivalent: 

nroff -T300 files ... and nroff files ... | 300 

nroff -T300-12 files ... and nroff files ... | 300 +12 

The use of 300 can thus often be avoided unless special delays or options 
are required; in a few cases, however, the additional movement optimization 
of 300 may produce better aligned output. 

SEE ALSO 

450(1), mesg(l), graph(lG), stty(l), tabs(l), tplot(lG). 

BUGS ^ , , 

Some special characters cannot be correctly printed in column 1 because the 
print head cannot be moved to the left from there. 

If your output contains Greek and/or reverse line-feeds, use a friction-feed 
platen instead of a forms tractor; although good enough for drafts, the latter 
has a tendency to slip when reversing direction, distorting Greek characters 
and misaligning the first line of text after one or more reverse line-feeds. 

NOTE 

fro^(l), nroff (1\ and eqn(l) are not part of this UNIX system release. 
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NAME 

4014 - paginator for the TEKTRONIX 4014 terminal 
SYNOPSIS 

4014 [ -t ] [ -n ] [ -cN ] [ -pL ] [ file ] 
DESCRIPTION 

The output of 4024 is intended for a TEKTRONIX 4014 terminal; 4024 
arranges for 66 lines to fit on the screen, divides the screen into N columns, 
and contributes an eight-space page offset in the (default) single-column 
case. Tabs, spaces, and backspaces are collected and plotted when neces- 
sary. TELETYPE Model 37 half- and reverse-line sequences are interpreted 
and plotted. At the end of each page, 4024 waits for a new-line (empty 
line) from the keyboard before continuing on to the next page. In this wait 
state, the command Icmd will send the cmd to the shell. 

The command line options are: 

-t Do not wait between pages (useful for directing output into a file). 

-n Start printing at the current cursor position and never erase the 
screen. 

-cN Divide the screen into N columns and wait after the last column. 

-pL Set page length to L; L accepts the scale factors i (inches) and 1 
(lines); default is lines. 

SEE ALSO 

pr(l). 
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NAME 

450 - handle special functions of the DASI 450 terminal 

SYNOPSIS 
450 

DESCRIPTION 

The 450 command supports special functions of, and optimizes the use of, 
the DASI 450 terminal, or any terminal that is functionally identical, such as 
the Diablo 1620 or Xerox 1700. It converts half-line forward, half-line 
reverse, and full-line reverse motions to the correct vertical motions. It also 
attempts to draw Greek letters and other special symbols in the same 
manner as 300(1). It should be noted that, unless your system contains 
DOCUMENTER'S WORKBENCH Software, certain commands (e.g., eqn, nroff, 
thl, etc.) will not work. Use 450 to print equations neatly, in the sequence: 

neqn file ... | nroff | 450 

WARNING: Make sure that the PLOT switch on your terminal is ON before 
450 is used. The SPACING switch should be put in the desired position 
(either 10- or 12-pitch). In either case, vertical spacing is 6 lines/inch, 
unless dynamically changed to 8 lines per inch by an appropriate escape 
sequence. 

Use 450 with the nroff -s flag or .rd requests when it is necessary to insert 
paper manually or change fonts in the middle of a document. Instead of 
hitting the return key in these cases, you must use the line-feed key to get 
any response. 

In many (but not all) cases, the use of 450 can be eliminated in favor of one 
of the following: 

nroff -T450 files . . . 

or 

nroff -T450-12 files . . . 

The use of 450 can thus often be avoided unless special delays or options 
are required; in a few cases, however, the additional movement optimization 
of 450 may produce better aligned output. 

SEE ALSO 

300(1), mesg(l), stty(l), tabs(l), graph(lG), tplot(lG). 

BUGS 

Some special characters cannot be correctly printed in column 1 because the 
print head cannot be moved to the left from there. 

If your output contains Greek and/or reverse line-feeds, use a friction-feed 
platen instead of a forms tractor; although good enough for drafts, the latter 
has a tendency to slip when reversing direction, distorting Greek characters 
and misaligning the first line of text after one or more reverse line-feeds. 

NOTE 

troff{\\ nroff {\), and eqn{\) are not part of this UNIX system release. 
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NAME 

Uutry - try to contact remote system with debugging on 
SYNOPSIS 

/usr/lib/uucp/Uutry [ -x debug_level ] [ -r ] system_name 
DESCRIPTION 

Uutry is a shell that is used to invoke uucico to call a remote site. Debug- 
ging is turned on (default is level 5); -x will override that value. The -r 
overrides the retry time in /usr/spool/uucp/.status. The debugging output 
is put in file /imp /system— name, A tail -f of the output is executed. A 
<DELETE> or <BREAK> will give control back to the terminal while the 
uucico continues to run, putting its output in /imp /system— name. 

FILES 

/usr/lib /uucp/Systems 
/usr /lib /uucp /Permissions 
/usr /lib /uucp /Devices 
/usr/lib/uucp/Maxuuxqts 
/usr /lib / uucp /Maxuuscheds 
/usr/spool /uucp /* 
/usr/spool/locks/LCK* 
/usr /spool /uucppublic /* 
/tmp/system_name 

SEE ALSO 

uucico(lM), uucp(lC), uux(lC). 



- 1 - 



ACCEPT(IM) 



(Base System) 



ACCEPT(IM) 



NAME 

accept, reject - allow or prevent LP requests 

SYNOPSIS 

/usr/lib/accept destinations 
/usr/lib/reject [-r[ reason]] destinations 

DESCRIPTION 

The accept command allows lp(l) to accept requests for the named destina- 
tions. A destination can be either a line printer (LP) or a class of printers. 
Use lpstat{l) to find the status of destinations. 

The reject command prevents lp{l) from accepting requests for the named 
destinations. A destination can be either a printer or a class of printers. Use 
lpstat{l) to find the status of destinations. The following option is useful 
with reject. 

-r[ reason ] Associates a reason with preventing Ip from accepting requests. 

This reason applies to all printers mentioned up to the next -r 
option. Reason is reported by Ip when users direct requests to 
the named destinations and by lpstat(l). If the -r option is not 
present or the -r option is given without a reason, then a 
default reason will be used. 

FILES 

/usr/spool/lp/* 
SEE ALSO 

enable(l), lp(l), Ipadmin(lM), Ipsched(lM), Ipstat(l). 
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NAME 

acct: acctdisk, acctdusg, accton, acctwtmp - overview of accounting and 
miscellaneous accounting commands 

SYNOPSIS 

/usr/lib/acct/acctdisk 

/usr/lib/acct/acctdusg [-u file] [-p file] 

/usr/lib/acct/accton [file] 

/usr/lib/acct/acctwtmp " reason " 

DESCRIPTION 

Accounting software is structured as a set of tools (consisting of both C pro- 
grams and shell procedures) that can be used to build accounting systems. 
When the system is installed, accounting is initially in the ''off state. 
acctsh{lM) describes the set of shell procedures built on top of the C pro- 
grams. 

Connect time accounting is handled by various programs that write records 
into /etc/utmp, as described in utmp{^). The programs described in 
acctcon (IM) convert this file into session and charging records, which are 
then summarized by acctmerg (IM). 

Process accounting is performed by the UNIX system kernel. Upon termina- 
tion of a process, one record per process is written to a file (normally 
/usr/adm/pacct). The programs in acctprc(lM) summarize this data for 
charging purposes; acctcms{lM) is used to summarize command usage. 
Current process data may be examined using acctcom(l). 

Process accounting and connect time accounting [or any accounting records 
in the format described in acct (4)] can be merged and summarized into total 
accounting records by acctmerg [see tacct format in acct(4)]. prtacct [see 
acctsh(lM)] is used to format any or all accounting records. 

acctdisk reads lines that contain user ID, login name, and number of disk 
blocks and converts them to total accounting records that can be merged 
with other accounting records. 

acctdusg reads its standard input (usually from find / -print) and computes 
disk resource consumption (including indirect blocks) by login. If -u is 
given, records consisting of those file names for which acctdusg charges no 
one are placed in file (a potential source for finding users trying to avoid 
disk charges). If -p is given, file is the name of the password file. This 
option is not needed if the password file is /etc/passwd. [See diskusg(lM) 
for more details.] 

accton alone turns process accounting off. If file is given, it must be the 
name of an existing file -to which the kernel appends process accounting 
records [see acct (2) and acct (4:)]. 

acctwtmp writes a utmp{4:) record to its standard output. The record con- 
tains the current time and a string of characters that describe the reason. A 
record type of ACCOUNTING is assigned [see utmp(4)]. Reason must be a 
string of 11 or fewer characters, numbers, $, or spaces. For example, the 
following are suggestions for use in reboot and shutdown procedures. 
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respectively: 

acctwtmp uname » /etc/wtmp 
acctwtmp "file save" » /etc/wtmp 

FILES 

/etc/passwd used for login name to user ID conversions 
/usr/lib/acct holds all accounting commands listed in sub-class IM of 
this manual 

/usr/adm/pacct current process accounting file 
/etc/wtmp login/logoff history file 

SEE ALSO 

acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), 
acctsh(lM), diskusg(lM), fwtmp(lM), runacct(lM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference Manual, 
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NAME 

acctcms - command summary from per-process accounting records 

SYNOPSIS 

/usr/lib/acct/acctcms [options] files 

DESCRIPTION 

acctcms reads one or more files, normally in the form described in accf (4). It 
adds all records for processes that executed identically-named commands, 
sorts them, and writes them to the standard output, normally using an inter- 
nal summary format. The options are: 

-a Print output in ASCII rather than in the internal summary format. 
The output includes command name, number of times executed, 
total kcore-minutes, total CPU minutes, total real minutes, mean size 
(in K), mean CPU minutes per invocation, "hog factor", characters 
transferred, and blocks read and written, as in acctcom{l). Output is 
normally sorted by total kcore-minutes. 

-c Sort by total CPU time, rather than total kcore-minutes. 

-j Combine all commands invoked only once under "***other". 

-n Sort by number of command invocations. 

-s Any file names encountered hereafter are already in internal sum- 
mary format. 

-t Process all records as total accounting records. The default internal 
summary format splits each field into prime and non-prime time 
parts. This option combines the prime and non-prime time parts 
into a single field that is the total of both, and provides upward 
compatibility with old (i.e., UNIX System V) style acctcms internal 
summary format records. 

The following options may be used only with the -a option. 

-p Output a prime-time-only command summary. 

-o Output a non-prime (offshift) time only command summary. 

When -p and -o are used together, a combination prime and non-prime 
time report is produced. All the output summaries will be total usage 
except number of times executed, CPU minutes, and real minutes which will 
be split into prime and non-prime. 

A typical sequence for performing daily command accounting and for main- 
taining a running total is: 

acctcms file . . . >today 

cp total previoustotal 

acctcms -s today previoustotal >total 

acctcms -a -s today 

SEE ALSO 

acct(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), 
fwtmp(lM), runacct(lM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference Manual 



- 1 - 



ACCTCMS(IM) (Base System) ACCTCMS(IM) 



BUGS 

Unpredictable output results if -t is used on new style internal summary 
format files, or if it is not used with old style internal summary format files. 
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NAME 

acctcom - search and print process accounting file(s) 

SYNOPSIS 

acctcom [[ options ][ file ] ] . . . 

DESCRIPTION 

acctcom reads file, the standard input, or /usr/adm/pacct, in the form 
described by acct{4) and writes selected records to the standard output. 
Each record represents the execution of one process. The output shows the 
COMMAND NAME, USER, TTYNAME, START TIME, END TIME, REAL 
(SEC), CPU (SEC), MEAN SIZE(K), and optionally, F (the fork /exec flag: 1 for 
fork without exec), STAT (the system exit status), HOG FACTOR, KCORE 
MIN, CPU FACTOR, CHARS TRNSFD, and BLOCKS READ (total blocks read 
and written). 

The command name is prepended with a # if it was executed with super- 
user privileges. If a process is not associated with a known terminal, a ? is 
printed in the TTYNAME field. 

If no files are specified, and if the standard input is associated with a termi- 
nal or /dev/nuU (as is the case when using & in the shell), 
/usr/adm/pacct is read; otherwise, the standard input is read. 

If any file arguments are given, they are read in their respective order. Each 
file is normally read forward, i.e., in chronological order by process comple- 
tion time. The file /usr/adm/pacct is usually the current file to be exam- 
ined; a busy system may need several such files of which all but the current 
file are found in /usr/adm/pacct.^. The options are: 

-a Show some average statistics about the processes selected. 

The statistics will be printed after the output records, 
-b Read backwards, showing latest commands first. This option 

has no effect when the standard input is read, 
-f Print the fork /exec flag and system exit status columns in the 

output. 

-h Instead of mean memory size, show the fraction of total avail- 

able CPU time consumed by the process during its execution. 
This "hog factor" is computed as: 

(total CPU time)/(elapsed time). 

Print columns containing the I/O counts in the output. 
Instead of memory size, show total kcore-minutes. 
Show mean core size (the default). 
Show CPU factor (user time/(system-time -f user-time). 
Show separate system and user CPU times. 
Exclude column headings from the output. 
Show only processes belonging to terminal /dev/line. 
Show only processes belonging to user that may be specified 
by: a user ID, a login name that is then converted to a user ID, 
a # which designates only those processes executed with 
super -user privileges, or ? which designates only those 
processes associated with unknown user IDs. 



-i 

-k 

-m 

-r 

-t 

-V 

-I line 
-u user 
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-g group Show only processes belonging to group. The group may be 

designated by either the group ID or group name, 
-s time Select processes existing at or after time, given in the format 

hr[:min [:sec]]. 
-e time Select processes existing at or before time . 
-S time Select processes starting at or after time . 

-E time Select processes ending at or before time . Using the same time 

for both -S and -E shows the processes that existed at time, 
-n pattern Show only commands matching pattern that may be a regular 
expression as in ed(l) except that + means one or more 
occurrences. 

-q Do not print any output records; just print the average statis- 

tics as with the -a option, 
-o of He Copy selected process records in the input data format to of He; 

suppress standard output printing. 
-H factor Show only processes that exceed factor, where factor is the 

"hog factor" as explained in option -h above. 
-O sec Show only processes with CPU system time exceeding sec 

seconds. 

-C sec Show only processes with total CPU time, system plus user, 

exceeding sec seconds. 
-I chars Show only processes transferring more characters than the 
cut-off number given by chars. 

/etc/passwd 
/usr/adm/pacct 
/etc/group 

SEE ALSO 

acct(lM), acctcms(lM), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), 
fwtmp(lM), ps(l), runacct(lM), su(lM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference Manual. 
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BUGS 



acctcom reports only on processes that have terminated; use ps{l) for active 
processes. If time exceeds the present time, then time is interpreted as 
occurring on the previous day. 
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NAME 

acctcon: acctconl, acctcon2 - connect-time accounting 

SYNOPSIS 

/usr/lib/acct/acctconl [options] 

/usr /lib /acct/acctcon2 

DESCRIPTION 

acctconl converts a sequence of login/logoff records read from its standard 
input to a sequence of records, one per login session. Its input should nor- 
mally be redirected from /etc/wtmp. Its output is ASCII, giving device, user 
ID, login name, prime connect time (seconds), non-prime connect time 
(seconds), session starting time (numeric), and starting date and time. The 
options are: 

-p Print input only, showing line name, login name, and time (in both 
numeric and date/time formats). 

-t acctconl maintains a list of lines on which users are logged in. 
When it reaches the end of its input, it emits a session record for 
each line that still appears to be active. It normally assumes that its 
input is a current file, so that it uses the current time as the ending 
time for each session still in progress. The -t flag causes it to use, 
instead, the last time found in its input, thus assuring reasonable 
and repeatable numbers for non-current files. 

-I file File is created to contain a summary of line usage showing line 
name, number of minutes used, percentage of total elapsed time 
used, number of sessions charged, number of logins, and number of 
logoffs. This file helps track line usage, identify bad lines, and find 
software and hardware oddities. Hang-up, termination of login (1) 
and termination of the login shell each generate logoff records, so 
that the number of logoffs is often three to four times the number of 
sessions. See mff(lM) and utmp(A). 

-o file File is filled with an overall record for the accounting period, giving 
starting time, ending time, number of reboots, and number of date 
changes. 

acctconl expects as input a sequence of login session records and converts 
them into total accounting records [see tacct format in acct(4)]. 

EXAMPLES 

These commands are typically used as shown below. The file ctmp is 
created only for the use of acctprc {IM) commands: 

acctconl -t -1 lineuse -o reboots <wtmp | sort -I- In -1-2 >ctmp 
acctcon2 <ctmp | acctmerg >ctacct 

FILES 

/etc/wtmp 
SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctmerg(lM), acctprc(lM), acctsh(lM), 
fwtmp(lM), init(lM), runacct(lM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference Manual, 
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BUGS 

The line usage report is confused by date changes. Use wtmpfix [see 
fwtmp{lM)] to correct this situation. 
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NAME 

acctmerg - merge or add total accounting files 
SYNOPSIS 

/usr/lib/acct/acctmerg [options] [file] . . . 
DESCRIPTION 

acctmerg reads its standard input and up to nine additional files, all in the 
tacct format [see acct{4)] or an ASCII version thereof. It merges these inputs 
by adding records whose keys (normally user ID and name) are identical, 
and expects the inputs to be sorted on those keys. Options are: 

-a Produce output in ASCII version of tacct. 
-i Input files are in ASCII version of tacct. 
-p Print input with no processing, 
-t Produce a single record that totals all input, 
-u Summarize by user ID, rather than user ID and name. 
-V Produce output in verbose ASCII format, with more precise notation for 
floating point numbers. 

EXAMPLES 

The following sequence is useful for making "repairs" to any file kept in 
this format: 

acctmerg -v <filel >file2 

edit file! as desired . . . 
acctmerg -i <file2 >filel 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctprc(lM), acctsh(lM), 
fwtmp(lM), runacct(lM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference Manual, 



- 1 - 



ACCTPRC(IM) 



(Base System) 



ACCTPRC(IM) 



NAME 

acctprc: acctprcl, acctprc2 - process accounting 

SYNOPSIS 

/usr/lib/acct/acctprcl [ctmp] 

/usr /lib /acct /acctprc2 

DESCRIPTION 

acctprcl reads input in the form described by flcc^(4), adds login names 
corresponding to user IDs, then writes for each process an ASCII line giving 
user ID, login name, prime CPU time (tics), non-prime CPU time (tics), and 
mean memory size (in memory segment units). If ctmp is given, it is 
expected to contain a list of login sessions, in the form described in 
acctcon{lM), sorted by user ID and login name. If this file is not supplied, it 
obtains login names from the passv^ord file. The information in ctmp helps 
it distinguish among different login names that share the same user ID. 

acctprcl reads records in the form written by acctprcl, summarizes them by 
user ID and name, then writes the sorted summaries to the standard output 
as total accounting records. 

These commands are typically used as shown below: 

acctprcl ctmp </usr/adm/pacct | acctprc2 >ptacct 

FILES 

/etc/passwd 
SEE ALSO 

acct(lM), acctcms(lM), acctcom(l) acctcon(lM), acctmerg(lM), acctsh(lM), 
cron(lM), fwtmp(lM), runacct(lM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference Manual. 

BUGS 

Although it is possible to distinguish among login names that share user IDs 
for commands run normally, it is difficult to do this for those commands 
run from crow (IM), for example. More precise conversion can be done by 
faking login sessions on the console via the acctwtmp program in acct{lM). 

CAVEAT 

A memory segment of the mean memory size is a unit of measure for the 
number of bytes in a logical memory segment on a particular processor. For 
example, on a PDP-11/70 this measure would be in 64-byte units, while on 
a VAXll/780 it would be in 512-byte units. 
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NAME 

acctsh: chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, prctmp, 
prdaily, prtacct, runacct, shutacct, startup, turnacct - shell procedures for 
accounting 

SYNOPSIS 

/usr/lib/acct/chargefee login-name number 
/usr/lib/acct/ckpacct [blocks] 
/usr/lib/acct/dodisk [-o] [files ...] 
/usr /lib /acct /lastlogin 
/usr/lib/acct/monacct number 
/usr/lib/acct/nuUadm file 
/usr/lib/acct/prctmp 
/usr/lib/acct/prdaily [-1] [-c] [ mmdd ] 
/usr/lib/acct/prtacct file [ "heading" ] 
/usr/lib/acct/runacct [mmdd] [mmdd state] 
/usr/lib/acct/shutacct [ "reason" ] 
/usr /lib /acct /startup 
/usr/lib/acct/turnacct on | off | switch 
DESCRIPTION 

chargefee can be invoked to charge a number of units to login-name. A 
record is written to /usr/adm/fee to be merged with other accounting 
records during the night. 

ckpacct should be initiated via cron(lM). It periodically checks the size of 
/usr/adm/pacct. If the size exceeds blocks, 1000 by default, turnacct will 
be invoked with argument switch. If the number of free disk blocks in the 
/usr file system falls below 500, ckpacct will automatically turn off the col- 
lection of process accounting records via the off argument to turnacct. 
When at least this number of blocks is restored, the accounting will be 
activated again. This feature is sensitive to the frequency at which ckpacct 
is executed, usually by cron . 

dodisk should be invoked by cron to perform the disk accounting functions. 
By default, it will do disk accounting on the special files in /etc/fstab. If the 
-o flag is used, it will do a slower version of disk accounting by login direc- 
tory. Files specify the one or more file system names where disk accounting 
will be done. If files are used, disk accounting will be done on these file 
systems only. If the -o flag is used, files should be mount points of 
mounted file system. If omitted, they should be the special file names of 
mountable file systems. 

lastlogin is invoked by runacct to update /usr/adm/acct/sum/loginlog, 
which shows the last date on which each person logged in. 

monacct should be invoked once each month or each accounting period. 
Number indicates which month or period it is. If number is not given, it 
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defaults to the current month (01-12). This default is useful if monacct is to 
executed via cron{lM) on the first day of each month, monacct creates sum- 
mary files in /usr/adm/acct/fiscal and restarts summary files in 
/usr/adm/acct/sum. 

nulladm creates file with mode 664 and ensures that owner and group are 
adm. It is called by various accounting shell procedures. 

prctmp can be used to print the session record file (normally 
/usr/adm/acct/nite/ctmp created by acctcon (IM). 

prdaily is invoked by runacct to format a report of the previous day's 
accounting data. The report resides in /usr/adm/acct/sum/rprtmrn^irf 
where mmdd is the month and day of the report. The current daily account- 
ing reports may be printed by typing prdaily. Previous days' accounting 
reports can be printed by using the mmdd option and specifying the exact 
report date desired. The -1 flag prints a report of exceptional usage by login 
id for the specified date. Previous daily reports are cleaned up and there- 
fore inaccessible after each invocation of monacct. The -c flag prints a 
report of exceptional resource usage by command, and may be used on 
current day's accounting data only. 

prtacct can be used to format and print any total accounting (tacct) file. 

runacct performs the accumulation of connect, process, fee, and disk 
accounting on a daily basis. It also creates summaries of command usage. 
For more information, see runacct(lM). 

shutacct is invoked during a system shutdown to turn process accounting 
off and append a "reason" record to /etc/wtmp. 

startup is called by /etc/init.d/acct to turn the accounting on whenever the 
system is brought to a multiuser state. 

turnacct is an interface to accton [see acct(lM)] to turn process accounting 
on or off. The switch argument turns accounting off, moves the current 
/usr/adm/pacct to the next free name in /usr/adm/pacctzwcr (where incr 
is a number starting with 1 and incrementing by one for each additional 
pacct file), then turns accounting back on again. This procedure is called by 
ckpacct and thus can be taken care of by the cron and used to keep pacct to 
a reasonable size, acct starts and stops process accounting via init and shut- 
down accordingly. 

FILES 

/usr/adm/fee 
/usr/adm/pacct 
/usr /adm /pacct* 

/etc/wtmp 

/usr /lib /acct /ptelus.awk 
/usr/lib/acct/ptecms.awk 
/usr /adm /acct /nite 



accumulator for fees 

current file for per-process accounting 

used if pacct gets large and during execution of 

daily accounting procedure 

login/logoff summary 

contains the limits for exceptional usage by login 
id 

contains the limits for exceptional usage by com- 
mand name 
working directory 
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/usr/lib/acct holds all accounting commands listed in sub- 

class IM of this manual 
/usr/adm/acct/sum summary directory, should be saved 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), 
cron(lM), diskusg(lM), fwtmp(lM), runacct(lM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference Manual. 
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NAME 

adduser - create a login for a new user 
SYNOPSIS 

adduser loginid name userid logdir Yes/No 
DESCRIPTION 

Adduser is used to create a login for a new user and must be given the fol- 
lowing arguments: 

loginid This is the user's login name. It can be no longer than eight 
alphanumeric characters. 

name This is the user's full name. It identifies the person to whom the 
login is assigned. If name contains spaces, it must be in quotes. 

userid This is the numerical user id that will be associated with the 
loginid. It must be between 100 and 50000 and must be unique for 
each user. 

logdir This is the user's home directory. It must be a valid directory 
name and cannot already exist on the system. Typically the user's 
home directory matches the login name. For example, the login 
"ams" might have a home directory of /usr/ams. 

Yes /No If the user will have system administration privileges. 
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NAME 

adv - advertise a directory for remote access 
SYNOPSIS 

adv [-r] [-d description] resource pathname [clients...] 
adv -m resource -d description I [clients...] 
adv -m resource [-d description] I clients... 
adv 
DESCRIPTION 

The adv command is the Remote File Sharing command used to make a 
computer's resource available to other computers. The machine that adver- 
tises the resource is called the server, while computers that mount and use 
the resource are clients. [See mount(lM).] (A resource represents a directory, 
which could contain files, subdirectories, named pipes and devices.) 

There are three ways adv is used: 1. to advertise the directory pathname 
under the name resource so it is available to Remote File Sharing clients; 2. 
to modify client and description fields for currently advertised resources; or 
3. to print a list of all locally advertised resources. 

The following options are available: 

-r Restricts access to the resource to a read-only basis. The 

default is read/write access. 

-d description Provides brief textual information about the advertised 
resource, description is a single argument surrounded by 
double quotes (") and has a maximum length of 32 charac- 
ters. 

resource This is the symbolic name used by the server and all 

authorized clients to identify the resource. It is limited to a 
maximum of 14 characters and must be different from every 
other resource name in the domain. All characters must be 
printable ASCII characters but must not include periods (.), 
slashes (/), or white space. 

pathname This is the local path name of the advertised resource. It is 

limited to a maximum of 64 characters. This path name 
cannot be the mount point of a remote resource and it can 
only be advertised under one resource name. 

clients These are the names of all clients that are authorized to 

remotely mount the resource. The default is that all 
machines that can connect to the server are authorized to 
access the resource. Valid input is of the form nodename, 
domain.nodename, domain,, or an alias that represents a list 
of client names. A domain name must be followed by a 
period (.) to distinguish it from a host name. The aliases 
are defined in /etc/host.alias and must conform to the 
alias capability in mailx{\). 



- 1 - 



ADV(IM) 



(Remote File Sharing Utilities) 



ADV(IM) 



-m resource This option modifies information for a resource that has 
already been advertised. The resource is identified by a 
resource name. Only the clients and description fields can 
be modified. (To change the pathname, resource name, or 
read/write permissions, you must unadvertise and re- 
advertise the resource.) 

When used with no options, adv displays all local resources that have been 
advertised; this includes the resource name, the path name, the description, 
the read/write status, and the list of authorized clients. The resource field 
has a fixed length of 14 characters; all others are of variable length. Fields 
are separated by tv^o white spaces, double quotes (") surround the descrip- 
tion, and blank lines separate each resource entry. 

This command may be used without options by any user; otherwise, it is 
restricted to the super-user. 

Remote File Sharing must be running before adv can be used to advertise or 
modify a resource entry. 

EXIT STATUS 

If there is at least one syntactically valid entry in the clients field, a warning 
will be issued for each invalid entry and the command will return a success- 
ful exit status. A non-zero exit status will be returned if the command fails. 

ERRORS 

If (1) the network is not up and running, (2) pathname is not a directory, (3) 
pathname isn't on a file system mounted locally, or (4) there is at least one 
entry in the clients field but none are syntactically valid, an error message 
will be sent to standard error. 

FILES 

/etc/host.alias 
SEE ALSO 

mailx(l) mount(lM), rfstart(lM), unadv(lM). 
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NAME 

at, batch - execute commands at a later time 

SYNOPSIS 

at time [ date ] [ + increment ] 
at -r job ... 
at -1 [ job ... ] 

batch 

DESCRIPTION 

The at and batch commands read commands from standard input to be exe- 
cuted at a later time, at allows you to specify when the commands should 
be executed, while jobs queued with batch will execute when system load 
level permits, at may be used with the following options: 

-r Removes jobs previously scheduled with at. 

-1 Reports all jobs scheduled for the invoking user. 

Standard output and standard error output are mailed to the user unless 
they are redirected elsewhere. The shell environment variables, current 
directory, umask, and ulimit are retained when the commands are executed. 
Open file descriptors, traps, and priority are lost. 

Users are permitted to use at if their name appears in the file 
/usr/lib/cron/at.allow. If that file does not exist, the file 
/usr/lib/cron/at.deny is checked to determine if the user should be denied 
access to at. If neither file exists, only root is allowed to submit a job. If 
at.deny is empty, global usage is permitted. The allow/deny files consist of 
one user name per line. These files can only be modified by the super-user. 

The time may be specified as 1, 2, or 4 digits. One- and two-digit numbers 
are taken to be hours, four digits to be hours and minutes. The time may 
alternately be specified as two numbers separated by a colon, meaning 
hour '.minute. A suffix am or pm may be appended; otherwise a 24-hour 
clock time is understood. The suffix zulu may be used to indicate GMT. 
The special names noon, midnight, now, and next are also recognized. 

An optional date may be specified as either a month name followed by a 
day number (and possibly year number preceded by an optional comma) or 
a day of the week (fully spelled or abbreviated to three characters). Two 
special "days", today and tomorrow are recognized. If no date is given, 
today is assumed if the given hour is greater than the current hour and 
tomorrow is assumed if it is less. If the given month is less than the 
current month (and no year is given), next year is assumed. 

The optional increment is simply a number suffixed by one of the following: 
minutes, hours, days, weeks, months, or years. (The singular form is also 
accepted.) 
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Thus legitimate commands include: 

at 0815am Jan 24 
at 8:15am Jan 24 
at now + 1 day 
at 5 pm Friday 

at and batch write the job number and schedule time to standard error. 

The at -r command removes jobs previously scheduled by at or batch . The 
job number is the number given to you previously by the at or batch com- 
mand. You can also get job numbers by typing at -1. You can remove only 
your own jobs unless you are the super-user. 

EXAMPLES 

The at and batch commands read from standard input the commands to be 
executed at a later time. sh(l) provides a different way of specifying stan- 
dard input. Within your commands, it may be useful to redirect standard 
output. 

This sequence can be used at a terminal: 

j batch 

sort filename >outfile 

<control-D> (hold down 'control' and depress 'D') 

This sequence, which demonstrates redirecting standard error to a pipe, is 
useful in a shell procedure (the sequence of output redirection specifications 
is significant): 

batch «! 

sort filename 2>&1 >outfile i mail loginid 
! 

To have a job reschedule itself, invoke at from within the shell procedure 
by including code similar to the following within the shell file: 

echo "sh shellfile" I at 1900 thursday next week 

FILES 

/usr/lib/cron 
/usr /lib /cron /at.allow 
/usr /lib /cron /at.deny 
/usr /lib /cron /queue 
/usr /spool /cron /atj obs 

SEE ALSO 

cron(lM), kill(l), mail(l), nice(l), ps(l), sh(l), sort(l). 
DIAGNOSTICS 

Complains about various syntax errors and times out of range. 



main cron directory 
list of allowed users 
list of denied users 
scheduling information 
spool area 
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NAME 

awk - pattern scanning and processing language 
SYNOPSIS 

awk [ -Fc ] [ prog ] [ parameters ] [ files ] 
DESCRIPTION 

The awk language scans each input file for lines that match any of a set of 
patterns specified in prog. With each pattern in prog there can be an associ- 
ated action that will be performed when a line of a file matches the pattern. 
The set of patterns may appear literally as prog, or in a file specified as -f 
file. The prog string should be enclosed in single quotes (') to protect it 
from the shell. 

Parameters, in the form x=... y=... etc., may be passed to awk. 

Files are read in order; if there are no files, the standard input is read. The 
file name - means the standard input. Each line is matched against the pat- 
tern portion of every pattern-action statement; the associated action is per- 
formed for each matched pattern. 

An input line is made up of fields separated by white space. (This default 
can be changed by using FS; see below). The fields are denoted $1, $2, ... ; 
$0 refers to the entire line. 

A pattern-action statement has the form: 

pattern { action } 

A missing action means print the line; a missing pattern always matches. 
An action is a sequence of statements. A statement can be one of the fol- 
lowing: 

if ( conditional ) statement [ else statement ] 
while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 

break 

continue 

{ [ statement ] . . . } 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 

next # skip remaining patterns on this input line 

exit # skip the rest of the input 

Statements are terminated by semicolons, new-lines, or right braces. An 
empty expression-list stands for the whole line. Expressions take on string 
or numeric values as appropriate, and are built using the operators +, -, *, 
/, %, and concatenation (indicated by a blank). The C operators ++, — , 
+=, -=, *=, /=, and Vo= are also available in expressions. Variables may 
be scalars, array elements (denoted x[i]), or fields. Variables are initialized 
to the null string. Array subscripts may be any string, not necessarily 
numeric; this allows for a form of associative memory. String constants are 
quoted ("). 
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The print statement prints its arguments on the standard output (or on a file 
if >expr is present), separated by the current output field separator, and ter- 
minated by the output record separator. The printf statement formats its 
expression list according to the format [see printf(3S) in the Programmer's 
Reference Manual]. 

The built-in function length returns the length of its argument taken as a 
string, or of the whole line if no argument is present. There are also built-in 
functions exp, log, sqrt, and int. The last truncates its argument to an 
integer; suhstr{s, m, n) returns the n-character substring of s that begins at 
position m. The function sprintf(fmt, expr, expr, ...) formats the expressions 
according to the printf(3S) format given by fmt and returns the resulting 
string. 

Patterns are arbitrary Boolean combinations ( !, | | , &&, and parentheses) of 
regular expressions and relational expressions. Regular expressions must be 
surrounded by slashes and are as in egrep [see grep(l)l Isolated regular 
expressions in a pattern apply to the entire line. Regular expressions may 
also occur in relational expressions. A pattern may consist of two patterns 
separated by a comma; in this case, the action is performed for all lines 
between an occurrence of the first pattern and the next occurrence of the 
second. 

A relational expression is one of the following: 

expression matchop regular-expression 
expression relop expression 

where relop is any of the six relational operators in C, and matchop is either 
~ (for contains) or f (for does not contain). A conditional is an arithmetic 
expression, a relational expression, or a Boolean combination of these. 
The special patterns BEGIN and END may be used to capture control before 
the first input line is read and after the last. BEGIN must be the first pattern, 
END the last. 

A single character c may be used to separate the fields by starting the pro- 
gram with: 

BEGIN { FS = C } 

or by using the -Fc option. 

Other variable names with special meanings include NF, the number of 
fields in the current record; NR, the ordinal number of the current record; 
FILENAME, the name of the current input file; OFS, the output field separator 
(default blank); ORS, the output record separator (default new-line); and 
OFMT, the output format for numbers (default %.6g). 

EXAMPLES 

Print lines longer than 72 characters: 

length > 72 
Print first two fields in opposite order: 
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{ print $2, $1 } 

Add up first column, print sum and average: 
{ s += $1 } 

END { print "sum is", s, " average is", s/NR } 

Print fields in reverse order: 

{ for (i = NF; i > 0; --i) print $i } 

Print all lines between start/stop pairs: 
/start/, /stop/ 

Print all lines whose first field is different from previous one: 
$1 != prev { print; prev = $1 } 

Print file, filling in page numbers starting at 5: 

/Page/ { $2 = n++; } 
{ print } 

command line: awk -f program n=5 input 

SEE ALSO 

grep(l), sed(l). 

lex(l), printf(3S) in the Programmer's Reference Manual. 

BUGS 

Input white space is not preserved on output if fields are involved. 
There are no explicit conversions between numbers and strings. To force an 
expression to be treated as a number, add to it; to force it to be treated as 
a string, concatenate the null string ( " " ) to it. 
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NAME 

backup - performs backup functions 
SYNOPSIS 

backup [-t] [-p I -c I -f <files> I -u "<userl> [user2]"] 
-d <device> 

backup -h 

DESCRIPTION 

-h produces a history of backups. Tells the user when the last com- 
plete and incremental/partial backups were done. 

-c complete backup. All files changed since the system was installed 
are backed up. 

-p incremental/partial backup. If an incremental/partial backup was 
done, all files modified since that time are backed up, otherwise all 
files modified since the last complete backup are backed up. A 
complete backup must be done before a partial backup. 

-f backup files specified by the <files> argument. File names may 
contain characters to be expanded ( i.e., *, .) by the shell. The argu- 
ment must be in quotes. 

-u backup a user's home directory. All files in the user's home direc- 
tory will be backed up. At least one user must be specified but it 
can be more. The argument must be in quotes if more than one 
user is specified. If the user name is "all", then all the user's home 
directories will be backed up. 

-d used to specify the device to be used. It defaults to 
/dev/rdsk/f0ql5d (the 1.2M floppy). 

-t used when the device is a tape. This option must be used with the 
-d option when the tape device is specified. 

A complete backup must be done before a partial backup can be done. Raw 
devices rather than block devices should always be used. The program can 
handle multi-volume backups. The program will prompt the user when it is 
ready for the next medium. The program will give you an estimated 
number of floppies/tapes that will be needed to do the backup. Floppies 
MUST be formatted before the backup is done. Tapes do not need to be 
formatted. If backup is done to tape, the tape must be rewound. 

SEE ALSO 

qt(7). 
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NAME 

banner - make posters 

SYNOPSIS 

banner strings 

DESCRIPTION 

The banner command prints its arguments (each up to 10 characters long) in 
large letters on the standard output. Spaces can be included in an argument 
by surrounding it with quotes. The maximum number of characters that can 
be accommodated in a line is implementation-dependent; excess characters 
are simply ignored. 

SEE ALSO 

echo(l). 
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NAME 

basename, dimame - deliver portions of path names 

SYNOPSIS 

basename string [ suffix ] 
dimame string 

DESCRIPTION 

The basename command deletes any prefix ending in / and the suffix (if 
present in string) from string, and prints the result on the standard output. 
It is normally used inside substitution marks C within shell procedures. 
The dirname command delivers all but the last level of the path name in 
string. 
EXAMPLES 

The following example, invoked with the argument /usr/src/cmd/cat.c, 
compiles the named file and moves the output to a file named cat in the 
current directory: 
cc $1 

mv a.out 'basename $1 '\.c" 

The following example will set the shell variable NAME to /usr/src/cmd: 
NAME='dimame /usr/src/cmd/cat.c' 

SEE ALSO 

sh(l). 
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NAME 

be - arbitrary-precision arithmetic language 

SYNOPSIS 

be [ -c ] [ -1 ] [ file ... ] 

DESCRIPTION 

The be command is an interactive processor for a language that resembles C 
but provides unlimited precision arithmetic. It takes input from any files 
given, then reads the standard input. The bc{l) utility is actually a prepro- 
cessor for dc{l), which it invokes automatically unless the -c option is 
present. In this case the dc input is sent to the standard output instead. 
The options are as follows: 

-c Compile only. The output is send to the standard output. 

-1 Argument stands for the name of an arbitrary precision math 
library. 

The syntax for be programs is as follows; L means letter a-z, E means 
expression, S means statement. 

Comments 

are enclosed in /* and */. 

Names 

simple variables: L 

array elements: L [ E ] 

The words "ibase", "obase", and "scale" 

Other operands 

arbitrarily long numbers with optional sign and decimal point. 
(E) 

sqrt ( E ) 

length ( E ) number of significant decimal digits 
scale ( E ) number of digits right of decimal point 
L(E E) 

Operators 

+ - * / % (% is remainder; is power) 
++ — (prefix and postfix; apply to names) 
== <= >=!=<> 
= =-h =- =* =/=o/o = 

Statements 
E 

{ S ; ... ; S } 
if ( E ) S 
while ( E ) S 
for ( E ; E ; E ) S 
null statement 
break 
quit 



- 1 - 



BC(1) (Base System) BC(1) 



Function definitions 

define L ( L L ) { 
auto L, ... , L 
S; ... S 
return ( E ) 

} 

Functions in -1 math library 

s(x) sine 

c(x) cosine 

e(x) exponential 

l(x) log 

a(x) arctangent 

j(n,x) Bessel function 
All function arguments are passed by value. 

The value of a statement that is an expression is printed unless the main 
operator is an assignment. Either semicolons or new-lines may separate 
statements. Assignment to scale influences the number of digits to be 
retained on arithmetic operations in the manner of dc(l). Assignments to 
ibase or obase set the input and output number radix, respectively. 
The same letter may be used as an array, a function, and a simple variable 
simultaneously. All variables are global to the program. "Auto" variables 
are pushed down during function calls. When using arrays as function 
arguments or defining them as automatic variables, empty square brackets 
must follow the array name. 

EXAMPLE 

scale = 20 
define e(x){ 

auto a, b, c, i, s 
a = 1 
b = 1 
s = 1 

for(i=l; 1==1; i++){ 
a = a*x 
b = b*i 
c = a/b 

if(c ==0) return(s) 
s = s+c 

} 

} 

defines a function to compute an approximate value of the exponential func- 
tion and 

for(i=l; i<=10; i++) e(i) 
prints approximate values of the exponential function of the first ten 
integers. 
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FILES 

/usr/lib/lib.b mathematical library 
/usr/bin/dc desk calculator proper 

SEE ALSO 

dc(l). 

BUGS 

The be command does not yet recognize the logical operators, && and | | . 
For statement must have all three expressions (E's). 
Quit is interpreted when read, not when executed. 
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NAME 

bdiff - big diff 

SYNOPSIS 

bdiff filel file2 [n] [-s] 

DESCRIPTION 

The bdiff command is used in a manner analogous to diff(l) to find which 
lines in two files must be changed to bring the files into agreement. Its pur- 
pose is to allow processing of files which are too large for diff. 

The parameters to bdiff are: 

filel (filel) , . ^ . . 

The name of a file to be used. If filel (filel) is the standard mput 

is read. 

n The number of line segments. The value of n is 3500 by default. If 
the optional third argument is given and it is numeric, it is used as 
the value for n. This is useful in those cases in which 3500-line 
segments are too large for diff, causing it to fail, 
-s Specifies that no diagnostics are to be printed by bdiff (silent 
option). Note, however, that this does not suppress possible diag- 
nostic messages from diff(\), which bdiff calls. 
The bdiff command ignores lines common to the beginning of both files, 
splits the remainder of each file into n-line segments, and invokes diff upon 
corresponding segments. If both optional arguments are specified, they 
must appear in the order indicated above. 

The output of bdiff is exactly that of diff, with line numbers adjusted to 
account for the segmenting of the files (that is, to make it look as if the files 
had been processed whole). Note that because of the segmenting of the 
files, bdiff does not necessarily find a smallest sufficient set of file differ- 
ences. 



FILES 



/tmp/bd????? 



SEE ALSO 

diff(l). 
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NAME 

bfs - big file scanner 

SYNOPSIS 

bfs [ - ] name 

DESCRIPTION 

The bfs command is (almost) like ed{l) except that it is read-only and 
processes much larger files. Files can be up to 1024K bytes and 32K lines, 
with up to 512 characters per line, including new-line (255 for 16-bit 
machines), bfs is usually more efficient than ed{l) for scanning a file, since 
the file is not copied to a buffer. It is most useful for identifying sections of 
a large file where csplit(l) can be used to divide it into more manageable 
pieces for editing. 

Normally, the size of the file being scanned is printed, as is the size of any 
file written with the w command. The optional - suppresses printing of 
sizes. Input is prompted with * if P and a carriage return are typed, as in 
ed{l). Prompting can be turned off again by inputting another P and car- 
riage return. Note that messages are given in response to errors if prompt- 
ing is turned on. 

All address expressions described under ed{l) are supported. In addition, 
regular expressions may be surrounded with two symbols besides / and ?: 
> indicates downward search without wrap-around, and < indicates upward 
search without wrap-around. There is a slight difference in mark names: 
only the letters a through z may be used, and all 26 marks are remembered. 

The e, g, v, k, p, q, w, =, ! and null commands operate as described under 
ed(l). Commands such as — , +++-, +++=, -12, and +4p are accepted. 
Note that l,10p and 1,10 will both print the first ten lines. The f command 
only prints the name of the file being scanned; there is no remembered file 
name. The w command is independent of output diversion, truncation, or 
crunching (see the xo, xt, and xc commands below). The following addi- 
tional commands are available: 

xifile 

Further commands are taken from the named file. When an 
end-of-file is reached, an interrupt signal is received or an error 
occurs; reading resumes with the file containing the xf. The xf 
commands may be nested to a depth of 10. 

xn List the marks currently in use (marks are set by the k com- 
mand). 

xo [file] 

Further output from the p and null commands is diverted to the 
named file, which, if necessary, is created mode 666 (readable 
and writable by everyone), unless your umask setting [see 
umask{l)] dictates otherwise. If file is missing, output is diverted 
to the standard output. Note that each diversion causes trunca- 
tion or creation of the file. 
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This positions a label in a command file. The label is terminated 
by new-line, and blanks between the : and the start of the label 
are ignored. This command may also be used to insert com- 
ments into a command file, since labels need not be referenced. 

( . , . )xb /regular expression /label 

A jump (either upward or downward) is made to label if the 
command succeeds. It fails under any of the following condi- 
tions: 

1. Either address is not between 1 and $. 

2. The second address is less than the first. 

3. The regular expression does not match at least one 
line in the specified range, including the first and last 
lines. 

On success, . is set to the line matched and a jump is made to 
label. This command is the only one that does not issue an error 
message on bad addresses, so it may be used to test whether 
addresses are bad before other commands are executed. Note 
that the command 

xb/7 label 
is an unconditional jump. 

The xb command is allowed only if it is read from someplace 
other than a terminal. If it is read from a pipe, only a downward 
jump is possible, 
xt number 

Output from the p and null commands is truncated to at most 
number characters. The initial number is 255. 

xv[digit][spaces][value] 

The variable name is the specified digit followmg the xv. Ihe 
commands xvSlOO or xv5 100 both assign the value 100 to the 
variable 5. The command xv61,100p assigns the value l,100p to 
the variable 6. To reference a variable, put a % in front of the 
variable name. For example, using the above assignments for 
variables 5 and 6: 



l,%5p 

1,%5 

%6 

will all print the first 100 lines. 
g/%5/p 
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would globally search for the characters 100 and print each line 
containing a match. To escape the special meaning of %, a \ 
must precede it. 

g/".*\%[cds]/p 

could be used to match and list lines containing printf of charac- 
ters, decimal integers, or strings. 



Another feature of the xv command is that the first line of out- 
put from a UNIX system command can be stored into a variable. 
The only requirement is that the first character of value be an !. 
For example: 

.w junk 
xv5!cat junk 
!rm junk 
!echo "%5" 
xv6!expr %6 + 1 

would put the current line into variable 5, print it, and increment 
the variable 6 by one. To escape the special meaning of ! as the 
first character of value, precede it with a \. 

xv7\!date 

stores the value !date into variable 7. 
xbz label 

xbn label 

These two commands will test the last saved return code from 
the execution of a UNIX system command (Icommand) or nonzero 
value, respectively, to the specified label. The two examples 
below both search for the next five lines containing the string 
size. 

xv55 
: 1 

/size/ 

xvSlexpr %5 - 1 
!if 0%5 != exit 2 
xbn 1 
xv45 
: 1 

/size/ 

xv4!expr %4 - 1 
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!if 0%4 = exit 2 
xbz 1 

xc [switch] 

If switch is 1, output from the p and null commands is crunched; 
if switch is 0, it is not. Without an argument, xc reverses switch. 
Initially switch is set for no crunching. Crunched output has 
strings of tabs and blanks reduced to one blank and blank lines 
suppressed. 

SEE ALSO 

csplit(l), ed(l), umask(l). 

DIAGNOSTICS 

? for errors in commands if prompting is turned off. Self-explanatory error 
messages when prompting is on. 
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NAME 

boot - UNIX system boot program 
DESCRIPTION 

The boot program interactively loads and executes stand-alone UNIX pro- 
grams. While hoot is used primarily for loading and executing the UNIX sys- 
tem kernel, it can load and execute any other programs that are linked for 
stand-alone execution. The boot program is a required part of the UNIX Base 
Operating System software set and must be present in the root file system 
to ensure successful loading of the UNIX System kernel. Note that during 
installation of the UNIX operating system, a custom masterboot is placed on 
the hard disk. The masterboot program resides on sector of the hard disk 
and is the default boot program for hard-disk boot procedures. 

The system invokes the boot program each time the computer is started. It 
tries to locate the boot program on the floppy disk drive first; if the floppy 
disk drive is empty, the system invokes the hard-disk boot procedure. The 
boot procedure depends on v^hether you are booting from a floppy disk or 
hard disk, as described below. 

The floppy-disk boot procedure has two stages: 

1. The boot block in sector of the file system loads boot. 

2. boot executes and prompts the user. 

The hard-disk boot procedure has three stages: 

1. The ROMs load in the masterboot block from sector on the 
hard disk. 

2. The masterboot boot block then loads the partition boot block 
from sector of the active partition [see fdisk{lM)]. 

3. The remainder of boot is loaded from the next 29 sectors of the 
hard disk. 

When first invoked, boot displays the following status message: 
Booting the UNIX System . . . 

To instruct boot to use the default kernel and values specified in the boot 
default file, /etc/default/boot, press RETURN. If you press any key other 
than RETURN, boot pauses and prompts you for custom information. If you 
have just loaded the boot program from the distribution diskette, press 
RETURN so boot will use the default values. 

To load a program that is not the default program, press any key to inter- 
rupt boot. The boot program pauses and prompts you with the following 
message for the name of the program you want to load: 

Enter the name of a kernel to boot: 

The system waits at this point for you to type the name of the program you 
want to load and press RETURN. The length of the pause is the number of 
seconds specified with the TIMEOUT option in /etc/default/boot (see 
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''boot Options"). If you have not typed something after the specified 
number of seconds and AUTOBOOT is set to YES in /etc/default/boot, boot 
times out and behaves as though you pressed RETURN. The hoot program 
proceeds through the boot process, and init(lM) is passed an -a flag with no 
prompt argument. 

If you are booting from a program other than the boot program on the dis- 
tribution diskette, you must specify the location of the program by provid- 
ing a filename (if the program you want to load is on the default boot dev- 
ice). The filename must include the full pathname of the file containing the 
stand-alone program. To indicate a program other than the hoot program 
on the distribution diskette, use the following format: 

filename 

where filename is the standard UNIX system pathname. The filename argu- 
ment must start with a slash if the program is not in the root directory. If 
filename is the only argument typed at the boot prompt, boot looks for the 
filename on the default boot device and tries to boot from it. 

boot Options 

Options for the boot program can be set or changed with keywords in 
/etc/default/boot. The following keywords are recognized by hoot: 

Indicates whether or not hoot starts loading 
the kernel immediately or displays a boot 
prompt first. 

The default boot message is changed to 
string. 

The default boot prompt is changed to 
string. 

Sets default bootstring to hootstring. This is 
the string used by hoot when the user 
presses RETURN only to the boot prompt or 
when hoot times out. 



AUTOBOOT=YES or NO 



BOOTMSG=sfn>ig 



BOOTPROMPT=sfn>7g 



DEFBOOTSTR=f700fsfrmg 



lNlTFROG=path 



MEMRANGE=rangelrange...] 



Specifies an initialization program to be 
loaded and run before boot sizes memory. 

Tells boot where to look when sizing 
memory. A range is a pair of decimal 
addresses, separated by a dash (such as 
1M-4M), followed by a set of one-byte 
flags. This set of flags should be encoded 
as an integer in the range of 0-55. Use a 
colon (:) to separate addresses from flags. 
Note that only two flags are currently 
defined: (indicates no special properties) 
and 1 (indicates memory for which DMA is 
not allowed). All other flags are currently 
undefined and reserved for future use. In 
addresses, use "M" to indicate the word 
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"megabyte" and "K" to indicate the word 
"kilobyte." Both upward (such as 
15M-16M) and downward (such as 
16M-15M) address ranges are supported. 
The first address in the pair is inclusive; the 
last address is exclusive. 

TIMEOUT=wMm^7er If boot is waiting for a boot line from the 

user and TIMEOUT is set, boot will wait for 
number seconds, then use the default boot 
line defined by DEFBOOTSTR. 

Customizing the Boot Process 

You can set the boot process up to be automatic. To set up boot to run 
automatically, using the default configuration information in the 
/etc/default/boot file, set AUTOBOOT to YES in the /etc/default/boot file 
on the default root file system. This causes boot to display the default boot 
message and load the program. If an error occurs or a key is pressed during 
this automatic boot process, boot returns to the boot prompt and tries to 
load the program again. The boot program on the UNIX operating system 
installation diskette performs this automatic boot procedure. 

If AUTOBOOT is set to NO in the /etc/default/boot file on the default root 
file system, boot gives you an opportunity to type a bootstring before boot 
begins loading the program. If you do not type a bootstring at the prompt, 
boot assumes the user wants the default configuration. At this point, boot 
behaves as though AUTOBOOT is set to YES in the /etc/default/boot file. 
The ^700^ program reads the configuration in the /etc/default/boot file then 
displays the default boot message (BOOTMSG) and begins loading the pro- 
gram. 

Kernel Configuration 

The boot program passes any boot string typed at the boot prompt to the 
kernel except for the prompt string. The kernel reads the boot string to 
determine which peripherals are the root, pipe, swap, and dump devices. If 
no devices are specified in either the /etc/default/boot description or on 
the command line, the default devices compiled into the kernel are used. 
Additional arguments in the boot string can override the default. These 
additional arguments have the following form: 

dev=xx(m,o) 
where 

- dev is the desired system device (root[dev], pipe[dev], swap[dev], or 
dumpdev). 

- XX is the device name ("hd" for the hard disk or "fd" for floppy diskette 
device). 

- m is the minor device number. 

- is the offset in the partition (usually 0). 

If any combination of root, pipe, swap, or dumpdev is specified, those sys- 
tem devices will reside on that device with the unspecified system devices 
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using the defaults compiled in the kernel. Setting one device does not 
affect the default values for the other system devices. 

FILES 

/etc/boot 
/etc/default/boot 

SEE ALSO 

fdisk(lM), init(lM), fd(7), hd(7). 

DIAGNOSTICS 

The masterboot and boot programs have different error messages. The 
masterboot program displays an error message and locks the system. The 
following is a list of the most common masterboot messages and their mean- 
ings: 

lO ERR An error occurred when trying to read in the partition boot of 

the active operating system. 
BAD TBL The bootable partition indicator of at least one of the operating 

systems in the fdisk table contains an unrecognizable code. 
NO OS There was an unrecoverable error after trying to execute the 

active operating system's partition boot. 
The boot program displays an error message, then returns to its prompt. 
Some boot messages indicate fatal errors that cause the system to halt and 
require rebooting. Other boot messages are not fatal but indicate that the 
boot program is not running properly. 

The following four messages indicate fatal errors. When one of these mes- 
sages occurs, you will need to correct the problem described in the message 
and reboot the system: 

Error reading bootstrap 

The boot program could not locate the bootstrap, or the bootstrap is 
not readable. Make sure that the bootstrap is properly located on 
the specified boot device and is compatible with the kernel you are 
booting. Then reboot the system. 

No active partition on hard disk 

There is currently no active partition from which to run the boot 
program. Activate an appropriate partition and reboot the system. 

No root file system 

The boot program could not locate a root file system on the specified 
boot device. Make sure the boot device has a root file system and 
reboot the system. 

The following list describes boot warning messages. When one of these 
messages occurs, you will need to correct the problem described in the mes- 
sage and restart the boot program: 

Cannot load initprog 

The boot program cannot locate the initialization program specified 
with the INITPROG option, or the initialization program is not set 
up properly for execution. Make sure that the path argument to 
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INITPROG is a valid path and the file is executable. Then restart 
boot. 

Cannot open defaults file 

The boot program cannot locate the /etc/default/boot file on the 
boot device, or the file is not readable. Make sure that the 
/etc/default/boot file exists on the boot device and that the file is 
readable. Then restart boot. 

command argument missing or incorrect 

The boot program received a command with no argument or with an 
invalid argument. Make sure that command has the correct number 
of arguments and that all the arguments are valid, then restart boot. 
Cannot load file; file not found 

The boot program cannot locate file on the specified device, or file is 
not set up properly for execution. Check that file exists on the 
specified device and restart boot. 

Cannot load file; cannot read COFF header 

The specified Common Object File Format (COFF) file contains no 
file header, or the file header is not readable. Make sure that file 
contains a readable file header, then restart boot. 

Cannot load file; not an 80386 COFF binary 

The specified file is not an 80386 COFF binary. Check that the file 
you want to load is a COFF binary that is compatible with 80386 
systems and restart boot. 

Cannot load file; cannot read section header 

The specified file does not contain a section header, or the section 
header is not readable. Check that file contains a readable section 
header and restart boot. 

Cannot load file; cannot read BKI section 

The specified file does not include the bootstrap-kernel interface 
(BKI) section, or the BKI section is not readable. Make sure the BKI 
section of file is accurate for your version of the kernel and 
bootstrap, then restart boot. 

Cannot load file; BKI too old 

The BKI of the current bootstrap is not compatible with the BKI of 
the program (file) you are loading. Make sure that the BKI of the 
bootstrap and file are compatible and restart boot. 

Cannot load file; BKI too new 

The BKI of the current bootstrap is not compatible with the BKI of 
the program (file) you are loading. Make sure that the BKI of the 
bootstrap and file are compatible and restart boot. 

Cannot load file; missing text or data segment 

The specified file does not contain a necessary text or data segment. 
Check that file contains the proper text and data segments, then res- 
tart boot. 
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Cannot load file; missing BKI segment 

The specified file does not contain the BKI segment. Make sure that 
the BKI segment in file exists and is compatible with the BKI of the 
bootstrap. 

Cannot load file; required memory for kernel not present 

The amount of memory available for the kernel is not present or is 
inadequate. Make sure you have allocated enough memory for the 
kernel you want to load, then restart boot. 

Cannot load file; file too large 

The file is too large for the boot program to load. 

Too many lines in defaults file; extra lines ignored 

The file/etc/default/boot contains too many lines. All extra lines 
will be ignored. 

The computer always tries to boot from any diskette in the floppy diskette 
drive first. If the diskette does not contain a valid bootstrap program, errors 
occur. 

The boot program cannot be used to load programs that have not been 
linked for standalone execution. To create stand-alone programs, use the 
option of the UNIX system linker [ld(l)] and special stand-alone libraries. 
Although stand-alone programs can operate in real or protected mode, they 
must not be large or huge model programs. Programs in real mode can use 
the input/output routines of the computer's startup ROM. 
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NAME 

brc, bcheckrc - system initialization procedures 

SYNOPSIS 

/etc/brc 

/etc/bcheckrc 

DESCRIPTION 

These shell procedures are executed via entries in /etc/inittab by init (IM) 
whenever the system is booted (or rebooted). 

First, the bcheckrc procedure checks the status of the root file system. If the 
root file system is found to be bad, bcheckrc repairs it. 

Then, the brc procedure clears the mounted file system table, /etc/mnttab, 
and puts the entry for the root file system into the mount table. 

After these two procedures have executed, init checks for the initdefault 
value in /etc/inittab. This tells init in which run level to place the system. 
Since initdefault is initially set to 2, the system will be placed in the multi- 
user state via the /etc/rc2 procedure. 

Note that bcheckrc should always be executed before brc. Also, these shell 
procedures may be used for several run-level states. 

SEE ALSO 

fsck(lM), init(lM), rc2(lM), shutdown(lM). 
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NAME 

cal - print calendar 

SYNOPSIS 

cal [ [ month ] year ] 

DESCRIPTION 

The cal command prints a calendar for the specified year. If a month is also 
specified, a calendar just for that month is printed. If neither is specified, a 
calendar for the present month is printed. Year can be between 1 and 9999. 
The month is a number between 1 and 12. The calendar produced is that 
for England and the United States. 

EXAMPLES 

An unusual calendar is printed for September 1752. That is the month 11 
days were skipped to make up for lack of leap year adjustments. To see 
this calendar, type: cal 9 1752 

BUGS 

The year is always considered to start in January even though this is histori- 
cally naive. 

Beware that "cal 88" refers to the early Christian era, not the 20th century. 
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NAME 

calendar - reminder service 

SYNOPSIS 

calendar [ - ] 

DESCRIPTION 

The calendar command consults the file calendar in the current directory 
and prints out lines that contain today's or tomorrow's date anywhere in the 
line. Most reasonable month-day dates such as "Aug. 24," "august 24," 
"8/24," etc., are recognized, but not "24 August" or "24/8." On weekends 
"tomorrow" extends through Monday. 

When an argument is present, calendar does its job for every user who has a 
file calendar in his or her login directory and sends them any positive 
results by mail(l). Normally this is done daily by facilities in the UNIX 
operating system. 

FILES 

/usr/lib/calprog to figure out today's and tomorrow's dates 

/etc/passwd 

/tmp/cal* 

SEE ALSO 

mail(l). 

BUGS 

Your calendar must be public information for you to get reminder service. 
calendar's extended idea of "tomorrow" does not account for holidays. 
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NAME 

captoinfo - convert a termcap description into a terminfo description 
SYNOPSIS 

captoinfo [-v ...] [-V] [-1] [-w width] file ... 
DESCRIPTION 

The captoinfo command looks in file for termcap descriptions. For each one 
found, an equivalent terminfo (^) description is written to standard output, 
along with any comments found. A description which is expressed as rela- 
tive to another description (as specified in the termcap tc= field) will be 
reduced to the minimum superset before being output. 

If no file is given, then the environment variable TERMCAP is used for the 
file name or entry. If TERMCAP is a full path name to a file, only the termi- 
nal whose name is specified in the environment variable TERM is extracted 
from that file. If the environment variable TERMCAP is not set, then the 
file /etc/termcap is read. 

-V print out tracing information on standard error as the program 

runs. Specifying additional -v options will cause more detailed 
information to be printed. 

-V print out the version of the program in use on standard error and 

exit. 

-1 cause the fields to print out, one to a line. Otherwise, the fields 

will be printed several to a line, up to a maximum width of 60 
characters. 

-w change the output to width characters. 

FILES 

/usr/lib/terminfo/?/* compiled terminal description data base 
CAVEATS 

Certain termcap defaults are assumed to be true. For example, the bell char- 
acter (terminfo bel) is assumed to be ^G. The linefeed capability {termcap nl) 
is assumed to be the same for both cursor^down and scroll-forward (terminfo 
cudl and ind, respectively.) Padding information is assumed to belong at 
the end of the string. 

The algorithm used to expand parameterized information for termcap fields 
such as cursor-position (termcap cm, terminfo cup) will sometimes produce a 
string which, though technically correct, may not be optimal. In particular, 
the rarely used termcap operation %n will produce strings that are especially 
long. Most occurrences of these non-optimal strings will be flagged with a 
warning message and may need to be recoded by hand. 
The short two-letter name at the beginning of the list of names in a termcap 
entry, a hold-over from an earlier version of the UNIX system, has been 
removed. 
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DIAGNOSTICS 

tgetent failed with return code n (reason). 

The termcap entry is not valid. In particular, check for an 
invalid 'tc=' entry. 

unknown type given for the termcap code cc. 

The termcap description had an entry for cc whose type 
was not Boolean, numeric, or string. 

wrong type given for the Boolean (numeric, string) termcap code cc. 

The Boolean termcap entry cc was entered as a numeric or 
string capability, 

the Boolean (numeric, string) termcap code cc is not a valid name. 

An unknown termcap code was specified. 

tgetent failed on TERM=term. 

The terminal type specified could not be found in the 
termcap file. 

TERM=term: cap cc (info ii) is NULL: REMOVED 

The termcap code was specified as a null string. The 
correct way to cancel an entry is with an '@', as in 
':bs@:'. Giving a null string could cause incorrect 
assumptions to be made by the software which uses 
termcap or terminfo. 

a function key for cc was specified, but it already has the value vv. 

When parsing the ko capability, the key cc was specified 
as having the same value as the capability cc, but the key 
cc already had a value assigned to it. 

the unknown termcap name cc was specified in the ko termcap capability. 

A key was specified in the ko capability which could not 
be handled. 

the vi character v (info ii) has the value xx, but ma gives n. 

The ma capability specified a function key with a value 
different from that specified in another setting of the same 
key. 

the unknown vi key v was specified in the ma termcap capability. 

A vi(l) key unknown to captoinfo was specified in the ma 
capability. 

Warning: termcap sg (nn) and termcap ug (nn) had different values. 

terminfo assumes that the sg (now xmc) and ug values 
were the same. 

Warning: the string produced for // may be inefficient. 

The parameterized string being created should be rewrit- 
ten by hand. 
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Null termname given. 

The terminal type was null. This is given if the environ- 
ment variable TERM is not set or is null. 

cannot open file for reading. 

The specified file could not be opened. 

SEE ALSO 

infocmp(lM), tic(lM). 

curses (3X), terminfo(4) in the Programmer's Reference Manual 
Chapter 10 in the Programmer's Guide. 

NOTES 

The captoinfo command should be used to convert termcap entries to ter- 
minfo(4) entries because the termcap data base (from earlier versions of 
UNIX System V) may not be supplied in future releases. 
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NAME 

cat - concatenate and print files 

SYNOPSIS 

cat [-U] [-S] [-V [-t] [-6]] file ... 

DESCRIPTION 

cat reads each file in sequence and writes it on the standard output. Thus: 
"cat file" 

prints file on your terminal, and: 
cat filel file2 >file3 

concatenates filel and file2, and writes the results in file3. 

If no input file is given, or if the argument - is encountered, cat reads from 
the standard input file. 

The following options apply to cat: 

-u The output is not buffered. (The default is buffered output.) 
-s cat is silent about nonexistent files. 

-V Causes non-printing characters (with the exception of tabs, new- 
lines and form-feeds) to be printed visibly. ASCII control characters 
(octal 000 - 037) are printed as ^n, where n is the corresponding 
ASCII character in the range octal 100 - 137 (@, A, B, C, . . ., X, Y, 
Z, [, \, ], and _); the DEL character (octal 0177) is printed 
Other non -printable characters are printed as M-x, where x is the 
ASCII character specified by the low-order seven bits. 

The following options may be used with the -v option: 

-t Causes tabs to be printed as "/'s and formfeeds to be printed as 

-e Causes a $ character to be printed at the end of each line (prior to 
the new-line). 

The -t and -e options are ignored if the -v option is not specified. 
WARNING 

Redirecting the output of cat onto one of the files being read will cause the 
loss of the data originally in the file being read. For example, typing: 

cat filel file2 >filel 

will cause the original data in filel to be lost. 

SEE ALSO 

cp(l), pg(l), pr(l). 
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NAME 

cd - change working directory 

SYNOPSIS 

cd [ directory ] 

DESCRIPTION 

If directory is not specified, the value of shell parameter $HOME is used as 
the new working directory. If directory specifies a complete path starting 
with /, directory becomes the new working directory. If neither case 
applies, cd tries to find the designated directory relative to one of the paths 
specified by the $CDPATH shell variable. $CDPATH has the same syntax as, 
and similar semantics to, the $PATH shell variable, cd must have execute 
(search) permission in directory . 

Because a new process is created to execute each command, cd would be 
ineffective if it were written as a normal command; therefore, it is recog- 
nized and is internal to the shell. 

SEE ALSO 

pwd(l), sh(l). 

chdir(2) in the Programmer's Reference Manual 
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NAME 

chmod - change mode 

SYNOPSIS 

chmod mode file ... 

chmod mode directory ... 

DESCRIPTION 

The permissions of the named files or directories are changed according to 
mode, which may be symbolic or absolute. Absolute changes to permis- 
sions are stated using octal numbers: 

chmod nnn file(s) 

where n is a number from to 7. Symbolic changes are stated using 
mnemonic characters: 

chmod a operator b file(s) 

where a is one or more characters corresponding to user, group, or other; 
where operator is +, -, and =, signifying assignment of permissions; and 
where b is one or more characters corresponding to type of permission. 

An absolute mode is given as an octal number constructed from the OR of 
the following modes: 

4000 set user ID on execution 

20#0 set group ID on execution if # is 7, 5, 3, or 1 
enable mandatory locking if # is 6, 4, 2, or 

1000 sticky bit is turned on [see chmod(2)] 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 

Symbolic changes are stated using letters that correspond both to access 
classes and to the individual permissions themselves. Permissions to a file 
may vary depending on your user identification number (UID) or group 
identification number (GID). Permissions are described in three sequences 
each having three characters: 

User Group Other 

rwx rwx rwx 

This example (meaning that user, group, and others all have reading, writ- 
ing, and execution permission to a given file) demonstrates two categories 
for granting permissions: the access class and the permissions themselves. 

Thus, to change the mode of a file's (or directory's) permissions using 
chmod's symbolic method, use the following syntax for mode: 

[ who ] operator [ permission(s) ], ... 

A command line using the symbolic method would appear as follows: 

chmod g+rw file 
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This command would make file readable and writable by the group. 

The who part can be stated as one or more of the following letters: 

u user's permissions 

g group's permissions 

o others permissions 

The letter a (all) is equivalent to ugo and is the default if who is omitted. 

Operator can be + to add permission to the file's mode, - to take away per- 
mission, or = to assign permission absolutely. (Unlike other symbolic opera- 
tions, = has an absolute effect in that it resets all other bits.) Omitting per- 
mission is only useful with = to take away all permissions. 

Permission is any compatible combination of the following letters: 



r reading permission 

w writing permission 

X execution permission 

s user or group set-ID is turned on 

t sticky bit is turned on 

1 mandatory locking will occur during access 



Multiple symbolic modes separated by commas may be given, though no 
spaces may intervene between these modes. Operations are performed in 
the order given. Multiple symbolic letters following a single operator cause 
the corresponding operations to be performed simultaneously. The letter s 
is only meaningful with u or g, and t only works with u. 

Mandatory file and record locking (1) refers to a file's ability to have its 
reading or writing permissions locked while a program is accessing that file. 
It is not possible to permit group execution and enable a file to be locked on 
execution at the same time. In addition, it is not possible to turn on the 
set-group-ID and enable a file to be locked on execution at the same time. 
The following examples, 

chmod g+x,+l file 
chmod g-l-s,+l file 

are, therefore, illegal usages and will elicit error messages. 

Only the owner of a file or directory (or the super-user) may change a file's 
mode. Only the super-user may set the sticky bit on a non-directory file. 
In order to turn on a file's set-group-ID, your own group ID must 
correspond to the file's, and group execution must be set. 

EXAMPLES 

chmod a-x file 
chmod 444 file 

The first examples deny execution permission to all. The absolute (octal) 
example permits only reading permissions. 

chmod go+rw file 
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chmod 606 file 

These examples make a file readable and writable by the group and others. 

chmod +1 file 
This causes a file to be locked during access. 

chmod =rwx,g+s file 

chmod 2777 file 

These last two examples enable all to read, write, and execute the file; and 
they turn on the set-group-ID. 

NOTES 

In a Remote File Sharing environment, you may not have the permissions 
that the output of the Is -1 command leads you to believe. For more infor- 
mation see the "Mapping Remote Users" section of Chapter 9 of the 
Operations /System Administration Guide. 

SEE ALSO 

ls(l). 

chmod(2) in the Programmer's Reference Manual. 
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NAME 

chown, chgrp - change owner or group 

SYNOPSIS 

chown owner file ... 

chown owner directory ... 

chgrp group file ... 

chgrp group directory ... 

DESCRIPTION 

The chown command changes the owner of the files or directories to owner. 
The owner may be either a decimal user ID or a login name found in the 
password file. 

The chgrp command changes the group ID of the files or directories to group. 
The group may be either a decimal group ID or a group name found in the 
group file. 

If either command is invoked by other than the super-user, the set-user-ID 
and set-group-ID bits of the file mode, 04000 and 02000 respectively, will 
be cleared. 

Only the owner of a file (or the super-user) may change the owner or group 
of that file. 

FILES 

/etc/passwd 
/etc/group 

NOTES 

In a Remote File Sharing environment, you may not have the permissions 
that the output of the Is -I command leads you to believe. For more infor- 
mation see the "Mapping Remote Users" section of Chapter 10 of the 
User's /System Administrator's Guide. 

SEE ALSO 

chmod(l). 

chown(2), group(4), passwd(4) in the Programmer's Reference Manual. 
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NAME 

chroot - change root directory for a command 

SYNOPSIS 

/etc/chroot newroot command 

DESCRIPTION 

The chroot command causes the given command to be executed relative to 
the new root. The meaning of any initial slashes (/) in the path names is 
changed for the command and any of its child processes to newroot. Furth- 
ermore, upon execution, the initial working directory is newroot. 

Notice, however, that if you redirect the output of the command to a file: 

chroot newroot command >x 

will create the file x relative to the original root of the command, not the 
new one. 

The new root path name is always relative to the current root; even if a 
chroot is currently in effect, the newroot argument is relative to the current 
root of the running process. 

This command can be run only by the super-user. 

SEE ALSO 

cd(l). 

chroot(2) in the Programmer's Reference Manual. 

BUGS 

One should exercise extreme caution when referencing device files in the 
new root file system. 
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NAME 

chrtbl - generate character classification and conversion tables 

SYNOPSIS 

chrtbl [file] 

DESCRIPTION 

The chrtbl command creates a character classification table and an 
upper/lower-case conversion table. The tables are contained in a byte-sized 
array encoded such that a table lookup can be used to determine the charac- 
ter classification of a character or to convert a character [see ctype{3C)]. The 
size of the array is 257*2 bytes: 257 bytes are required for the 8-bit code 
set character classification table and 257 bytes for the upper- to lower-case 
and lower- to upper-case conversion table. 

chrtbl reads the user-defined character classification and conversion infor- 
mation from file and creates two output files in the current directory. One 
output file, ctype.c (a C-language source file), contains the 257*2-byte array 
generated from processing the information from file. You should review the 
content of ctype.c to verify that the array is set up as you had planned. (In 
addition, an application program could use ctype.c.) The first 257 bytes of 
the array in ctype.c are used for character classification. The characters 
used for initializing these bytes of the array represent character classifica- 
tions that are defined in /usr/include/ctype.h; for example, _L means a 
character is lower case and __S | _B means the character is both a spacing 
character and a blank. The last 257 bytes of the array are used for character 
conversion. These bytes of the array are initialized so that characters for 
which you do not provide conversion information will be converted to 
themselves. When you do provide conversion information, the first value of 
the pair is stored where the second one would be stored normally, and vice 
versa; for example, if you provide <0x41 0x61 >, then 0x61 is stored where 
0x41 would be stored normally, and 0x61 is stored where 0x41 would be 
stored normally. 

The second output file (a data file) contains the same information, but is 
structured for efficient use by the character classification and conversion 
routines [see ctype (3C)]. The name of this output file is the value of the 
character classification chrclass read in from file. This output file must be 
installed in the /lib/chrclass directory under this name by someone who is 
super-user or a member of group bin. This file must be readable by user, 
group, and other; no other permissions should be set. To use the character 
classification and conversion tables on this file, set the environmental vari- 
able CHRCLASS [see environ(5)] to the name of this file and export the vari- 
able; for example, if the name of this file (and character class) is xyz, you 
should issue the commands: CHRCLASS=xyz ; export CHRCLASS . 

If no input file is given, or if the argument - is encountered, chrtbl reads 
from the standard input file. 

The syntax of file allows the user to define the name of the data file created 
by chrtbl, the assignment of characters to character classifications and the 
relationship between upper- and lower-case letters. The character classifica- 
tions recognized by chrtbl are: 
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chrclass name of the data file to be created by chrtbL 

isupper character codes to be classified as upper-case letters. 

islower character codes to be classified as lower-case letters. 

isdigit character codes to be classified as numeric. 

isspace character codes to be classified as a spacing (delimiter) 
character. 

ispunct character codes to be classified as a punctuation char- 
acter. 

iscntrl character codes to be classified as a control character, 
isblank character code for the space character, 
isxdigit character codes to be classified as hexadecimal digits, 
ul relationship between upper- and lower-case characters. 

Any lines with the number sign (#) in the first column are treated as com- 
ments and are ignored. Blank lines are also ignored. 

A character can be represented as a hexadecimal or octal constant (for 
example, the letter a can be represented as 0x61 in hexadecimal or 0141 in 
octal). Hexadecimal and octal constants may be separated by one or more 
space and tab characters. 

The dash character (-) may be used to indicate a range of consecutive 
numbers. Zero or more space characters may be used for separating the 
dash character from the numbers. 

The backslash character (\) is used for line continuation. Only a carriage 
return is permitted after the backslash character. 

The relationship between upper- and lower-case letters (ul) is expressed as 
ordered pairs of octal or hexadecimal constants: <upper-case— character 
lower-case^character>. These two constants may be separated by one or 
more space characters. Zero or more space characters may be used for 
separating the angle brackets (< >) from the numbers. 

EXAMPLE 

The following is an example of an input file used to create the ASCII code 
set definition table on a file named ascii: 

chrclass ascii 

isupper 0x41 - 0x5a 

islower 0x61 - 0x7a 

isdigit 0x30 - 0x39 

isspace 0x20 0x9 - Oxd 

ispunct 0x21 - 0x2f 0x3a - 0x40 \ 

0x5b - 0x60 0x7b - 0x7e 
iscntrl 0x0 - Oxif 0x7f 
isblank 0x20 

isxdigit 0x30 - 0x39 0x61 - 0x66 \ 
0x41 - 0x46 

ul <0x41 Ox61> <0x42 Ox62> <0x43 0x63> \ 
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<0x44 


0x64> 


<0x45 0x65> 


<0x46 


Ox66> 


\ 


<0x47 


0x67> 


<0x48 Ox68> 


<0x49 


Ox69> 


\ 


<0x4a 


Ox6a> 


<0x4b Ox6b> 


<0x4c 


Ox6c> 


\ 


<0x4d 


0x6d> 


<0x4e 0x6e> 


<0x4f 


Ox6f> 


\ 


<0x50 


0x70> 


<0x51 0x7 1> 


<0x52 


0x72> 


\ 


<0x53 


0x73> 


<0x54 Ox74> 


<0x55 


0x75> 


\ 


<0x56 


0x76> 


<0x57 0x77> 


<0x58 


0x78> 


\ 


<0x59 


Ox79> 


<0x5a 0x7a> 









FILES 

/lib/chrclass/* data file containing character classification and conversion 
tables created by chrtbl 

/usr/include/ctype.h 

header file containing information used by character clas- 
sification and conversion routines 

SEE ALSO 

environ(5). 

ctype(3C) in the Programmer's Reference Manual . 
DIAGNOSTICS 

The error messages produced by chrtbl are intended to be self-explanatory. 
They indicate errors in the command line or syntactic errors encountered 
within the input file. 
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NAME 

clear - dear terminal screen 

SYNOPSIS 

/bin/clear 

DESCRIPTION 

clear clears your screen if it is possible to do so, It looks in the environ- 
ment for the terminal type and uses terminfo to figure out how to clear the 
screen. 
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NAME 

clri - clear inode 

SYNOPSIS 

/etc/clri special i-number ... 

DESCRIPTION . ^ ^ . 

The clri command writes nulls on the 64 bytes at offset i-number from the 
start of the inode list. This effectively eliminates the inode at that address. 
Special is the device name on which a file system has been defined. After 
clri is executed, any blocks in the affected file will show up as ''not 
accounted for" when fsck(lM) is run against the file system. The inode may 
be allocated to a new file. 

Read and write permission is required on the specified special device. 

This command is used to remove a file which appears in no directory; that 

is, to get rid of a file which cannot be removed with the rm command. 

SEE ALSO 

fsck(lM), fsdb(lM), ncheck(lM) rm(l). 
fs(4) in the Programmer's Reference Manual 

WARNINGS , . . • . 

If the file is open for writing, clri will not work. The file system contammg 

the file should NOT be mounted. 

If clri is used on the inode number of a file that does appear in a directory, 
it is imperative to remove the entry in the directory at once, since the inode 
may be allocated to a new file. The old directory entry, if not removed, 
continues to point to the same file. This sounds like a link, but does not 
work like one. Removing the old entry destroys the new file. 
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NAME 

cmp - compare two files 

SYNOPSIS 

cmp [ -1 ] [ -s ] filel file2 

DESCRIPTION 

The two files are compared. (If filel is the standard input is used.) 
Under default options, cmp makes no comment if the files are the same; if 
they differ, it announces the byte and line number at which the difference 
occurred. If one file is an initial subsequence of the other, that fact is noted. 
Options: 

-1 Print the byte number (decimal) and the differing bytes (octal) for 
each difference. 

-s Print nothing for differing files; return codes only. 

SEE ALSO 

comm(l), diff(l). 

DIAGNOSTICS 

Exit code is returned for identical files, 1 for different files, and 2 for an 
inaccessible or missing argument. 
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NAME 

col - filter reverse line-feeds 

SYNOPSIS 

col [-b] [-f] [-X] [-p] 

DESCRIPTION , J J . . T. 

col reads from the standard input and writes onto the standard output, it 
performs the line overlays implied by reverse line feeds (ASCII code ESC-7), 
and by forward and reverse half-line-feeds (ESC-9 and ESC-8). col is partic- 
ularly useful for filtering multicolumn output made with the .rt command of 
nroff and output resulting from use of the ^^7/(1) preprocessor. 
If the -b option is given, col assumes that the output device in use is not 
capable of backspacing. In this case, if two or more characters are to appear 
in the same place, only the last one read will be output. 
Although col accepts half-line motions in its input, it normally does not 
emit them on output. Instead, text that would appear between lines is 
moved to the next lower full-line boundary. This treatment can be 
suppressed by the -f (fine) option; in this case, the output from col may 
contain forward half-line-feeds (ESC-9), but will still never contain either 
kind of reverse line motion. 

Unless the -x option is given, col will convert white space to tabs on output 
wherever possible to shorten printing time. 

The ASCII control characters SO (\017) and SI (\016) are assumed by col to 
start and end text in an alternate character set. The character set to which 
each input character belongs is remembered, and on output SI and SO char- 
acters are generated as appropriate to ensure that each character is printed 
in the correct character set. 

On input, the only control characters accepted are space, backspace, tab, 
return, new-line, SI, SO, VT (\013), and ESC followed by 7, 8, or 9. The VT 
character is an alternate form of full reverse line-feed, included for compati- 
bility with some earlier programs of this type. All other non-printing char- 
acters are ignored. 

Normally, col will ignore any escape sequences unknown to it that are 
found in its input; the -p option may be used to cause col to output these 
sequences as regular characters, subject to overprinting from reverse line 
motions. The use of this option is highly discouraged unless the user is 
fully aware of the textual position of the escape sequences. 

NOTES 

The input format accepted by col matches the output produced by nroff with 
either the -T37 or -Tip options. Use -T37 (and the -f option of col) if the 
ultimate disposition of the output of col will be a device that can interpret 
half-line motions; use -Tip otherwise. 
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BUGS 

Cannot back up more than 128 lines. 

Allows at most 800 characters, including backspaces, on a line. 

Local vertical motions that would result in backing up over the first line of 
the document are ignored. As a result, the first line must not have any 
superscripts. 
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NAME 

comm - select or reject lines common to two sorted files 

SYNOPSIS 

comm [ - [ 123 ] ] filel file2 

DESCRIPTION 

The comm command reads filel and filel, which should be ordered m ASCII 
collating sequence [see sort(l)l and produces a three-column output: lines 
only in filel; lines only in filel; and lines in both files. The file name - 
means the standard input. 

Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm 
-12 prints only the lines common to the two files; comm -23 prints only 
lines in the first file but not in the second; comm -123 prints nothing. 

SEE ALSO 

cmp(l), diff(l), sort(l), uniq(l). 
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NAME 

copy - copy groups of files 

SYNOPSIS 

copy [ option ] ... source ... dest 

DESCRIPTION 

The copy command copies the contents of directories to another directory. 
It is possible to copy whole file systems since directories are made when 
needed. 

If files, directories, or special files do not exist at the destination, then they 
are created with the same modes and flags as the source. In addition, the 
super-user may set the user and group ID. The owner and mode are not 
changed if the destination file exists. Note that there may be more than one 
source directory. If so, the effect is the same as if the copy command had 
been issued for each source directory with the same destination directory for 
each copy. 

All options must be given as separate arguments, and they may appear in 
any order. The options are: 

-a Asks the user before attempting a copy. If the response does not 
begin with a "y", then a copy is not done. This option also sets 
the -ad option. 

-1 Uses links instead whenever they can be used. Otherwise, a copy 

is done. Note that links are never done for special files or direc- 
tories. 

-n Requires the destination file to be new. If not, then the copy com- 
mand does not change the destination file. The -n flag is mean- 
ingless for directories. For special files, an -n flag is assumed (i.e., 
the destination of a special file must not exist). 

-o If set then every file copied has its owner and group set to those of 
the source. If not set, then the file's owner is the user who 
invoked the program. 

-m If set, then every file copied has its modification time and access 
time set to that of the source. If not set, then the modification time 
is set to the time of the copy. 

-r If set, then every directory is recursively examined as it is encoun- 

tered. If not set, then any directories that are found are ignored. 

-ad Asks the user whether an -r flag applies when a directory is 
discovered. If the answer does not begin with a "y", then the 
directory is ignored. 

-V If the verbose option is set, messages are printed that reveal what 
the program is doing. 

source This may be a file, directory, or special file. It must exist. If it is 
not a directory, then the results of the command are the same as 
for the cp command. 
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dest The destination must be either a file or directory that is different 
from the source. 

If source and destination are anything but directories, then copy acts just like 
a cp command. If both are directories, then copy copies each file into the 
destination directory according to the flags that have been set. 

SEE ALSO 

chmod(l), cp(l). 

NOTES ^ . J J . 

Special device files can be copied. When they are copied, any data associ- 
ated with the specified device is not copied. 
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NAME 

cp. In, mv - copy, link, or move files 

SYNOPSIS 

cp filel [ file2 ...] target 

In [ -f ] filel [ file2 ...] target 

mv [ -f ] filel [ file2 ...] target 

DESCRIPTION 

filel is copied (linked, moved) to target. Under no circumstance can filel 
and target be the same [take care when using sh(l) metacharacters]. If tar- 
get is a directory, then one or more files are copied (linked, moved) to that 
directory. If target is a file, its contents are destroyed. 

If mv or In determines that the mode of target forbids writing, it will print 
the mode [see chmod{l)], ask for a response, and read the standard input for 
one line. If the line begins with y, the mv or In occurs, if permissible; if 
not, the command exits. For mv, when source parent directories or the tar- 
get directory is writable and has the sticky bit set, any of the following con- 
ditions must be true: 

the user must own the file 
the user must own the directory 
the file must be writable to the user 
the user must be the super-user 

When the -f option is used or if the standard input is not a terminal, no 
questions are asked and the mv or In is done. 

Only mv will allow filel to be a directory, in which case the directory 
rename will occur only if the two directories have the same parent; filel is 
renamed target. If filel is a file and target is a link to another file with links, 
the other links remain and target becomes a new file. 

When using cp, if target is not a file, a new file is created which has the 
same mode as filel except that the sticky bit is not set unless you are 
super-user; the owner and group of target are those of the user. If target is 
a file, copying a file into target does not change its mode, owner, nor group. 
The last modification time of target (and last access time, if target did not 
exist) and the last access time of filel are set to the time the copy was made. 
If target is a link to a file, all links remain and the file is changed. 

SEE ALSO 

chmod(l), cpio(l), rm(l). 

WARNINGS 

In will not link across file systems. This restriction is necessary because file 
systems can be added and removed. 

BUGS 

If filel and target lie on different file systems, mv must copy the file and 
delete the original. In this case any linking relationship with other files is 
lost. 
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NAME 

cpio - copy file archives in and out 
SYNOPSIS 

cpio -o[acBvV] [-C bufsize] [[-O file] [-M message]] 
cpio -i[BcdmrtuvVfsSb6k] [-C bufsize] [[-I file] [-M message]] [pat- 
tern ...] 

cpio -p[adlmuvV] directory 
DESCRIPTION 

cpio -0 (copy out) reads the standard input to obtain a list of path names 
and copies those files onto the standard output together with path name 
and status information. Output is padded to a 512-byte boundary by 
default. 

cpio -i (copy in) extracts files from the standard input, which is assumed to 
be the product of a previous cpio -o. Only files with names that match pat- 
terns are selected, patterns are regular expressions given in the filename- 
generating notation of sh{l). In patterns, metacharacters ?, *, and [...] 
match the slash (/) character, and backslash (\) is an escape character. A ! 
metacharacter means not. (For example, the !abc* pattern would exclude all 
files that begin with abc.) Multiple patterns may be specified and if no pat- 
terns are specified, the default for patterns is * (i.e., select all files). Each 
pattern must be enclosed in double quotes otherwise the name of a file in 
the current directory is used. Extracted files are conditionally created and 
copied into the current directory tree based upon the options described 
below. The permissions of the files will be those of the previous cpio -o . 
The owner and group of the files will be that of the current user unless the 
user is super-user, which causes cpio to retain the owner and group of the 
files of the previous cpio -o . NOTE: If cpio -z tries to create a file that 
already exists and the existing file is the same age or newer, cpio will output 
a warning message and not replace the file. (The -u option can be used to 
unconditionally overwrite the existing file.) 

cpio -p (pass) reads the standard input to obtain a list of path names of files 
that are conditionally created and copied into the destination directory tree 
based upon the options described below. Archives of text files created by 
cpio are portable between implementations of UNIX System V. 

The meanings of the available options are: 

-a Reset access times of input files after they have been copied. Access 
times are not reset for linked files when cpio -pla is specified. 

-b Reverse the order of the bytes within each word. Use only with the 
-i option. 

-B Input/output is to be blocked 5,120 bytes to the record. The default 
buffer size is 512 bytes when this and the -C options are not used. 
(-B does not apply to the pass option; -B is meaningful only with 
data directed to or from a character-special device, e.g., 
/dev/rdsk/f0ql5dt.) 
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-c Write header information in ASCII character form for portability. 

Always use this option when origin and destination machines are 

different types. 
-C bufsize 

Input/output is to be blocked bufsize bytes to the record, where buf- 
size is replaced by a positive integer. The default buffer size is 512 
bytes when this and -B options are not used. (-C does not apply to 
the pass option; -C is meaningful only with data directed to or from 
a character-special device, e.g., /dev/rmt/cOsO.) 
-d directories are to be created as needed. 

-f Copy in all files except those in patterns. (See the paragraph on 
cpio -i for a description of patterns.) 

-I file Read the contents of file as input. If file is a character-special dev- 
ice, when the first medium is full, replace the medium and type a 
carriage return to continue to the next medium. Use only with the 
-i option. 

-k Attempt to skip corrupted file headers and I/O errors that may be 
encountered. If you want to copy files from a medium that is cor- 
rupted or out of sequence, this option lets you read only those files 
with good headers. (For cpio archives that contain other cpio 
archives, if an error is encountered, cpio may terminate prematurely. 
cpio will find the next good header, which may be one for a smaller 
archive, and terminate when the smaller archive's trailer is encoun- 
tered.) Used only with the -i option. 

-1 Whenever possible, link files rather than copying them. Usable only 
with the -p option. 

-m Retain previous file modification time. This option is ineffective on 

directories that are being copied. 
-M message 

Define a message to use when switching media. When you use the 
-O or -I options and specify a character-special device, you can use 
this option to define the message that is printed when you reach the 
end of the medium. One %d can be placed in the message to print 
the sequence number of the next medium needed to continue. 
-O file Direct the output of cpio to file. If file is a character-special device, 
when the first medium is full, replace the medium and type a car- 
riage return to continue to the next medium. Use only with the -o 
option. 

-r Interactively rename files. If the user types a null line, the file is 

skipped. If the user types a the original pathname will be 

copied. (Not available with cpio -p.) 
-s swap bytes within each half word. Use only with the -i option. 
-S Swap halfwords within each word. Use only with the -i option, 
-t Print a table of contents of the input. No files are created, 
-u Copy unconditionally (normally, an older file will not replace a 

newer file with the same name). 
-V verbose: causes a list of file names to be printed. When used with 

the -t option, the table of contents looks like the output of an Is -1 

command [see /s(l)]. 
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-V SpecialVerbose: print a dot for each file seen. Useful to assure the 
user that cpio is working without printing out all file names. 

-6 Process an old (i.e., UNIX System Sixth Edition format) file. Use 
only with the -i option. 

NOTE: cpio assumes 4-byte words. 

If cpio reaches end of medium (end of a diskette for example) when writing 
to (-o) or reading from (-i) a character-special device, and -O and -I are not 
used, cpio will print the message: 

If you want to go on, type device/file name when ready. 

To continue, you must replace the medium and type the character-special 
device name (/dev/rdsk/f0ql5dt for example) and a carriage return. You 
may want to continue by directing cpio to use a different device. For exam- 
ple, if you have two floppy drives, you may want to switch between them 
so cpio can proceed while you are changing the floppies. (A carriage return 
alone causes the cpio process to exit.) 

EXAMPLES 

The following examples show three uses of cpio. 

When standard input is directed through a pipe to cpio -o, it groups the 
files so they can be directed (>) to a single file {, . /newfile). The -c option 
insures that the file will be portable to other machines. Instead of /s(l), you 
could use find{l), echo(l), caf(l), etc., to pipe a list of names to cpio. You 
could direct the output to a device instead of a file. 
Is I cpio -oc >.. /newfile 

cpio -i uses the output file of cpio -o (directed through a pipe with cat in 
the example), extracts those files that match the patterns (memo/al, 
memo/b*), creates directories below the current directory as needed (-d 
option), and places the files in the appropriate directories. The -c option is 
used when the file is created with a portable header. If no patterns were 
given, all files from newfile would be placed in the directory, 
cat newfile | cpio -icd "memo/al" "memo/b*" 

cpio -p takes the file names piped to it and copies or links (-1 option) those 
files to another directory on your machine (newdir in the example). The -d 
options says to create directories as needed. The -m option says retain the 
modification time. [It is important to use the -depth option of find{\) to 
generate path names for cpio. This eliminates problems cpio could have try- 
ing to create files under read-only directories.] 

find . -depth -print | cpio -pdlmv newdir 

SEE ALSO 

cat(l), echo(l), find(l), ls(l), tar(l). 

cpio(4) in the Programmer's Reference Manual. 
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NOTES 

1) Path names are restricted to 256 characters. 

2) Only the super-user can copy special files. 

3) Blocks are reported in 512-byte quantities. 

4) If a file has 000 permissions, contains more than characters of data, 
and the user is not root, the file will not be saved or restored. 
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NAME 

crash - examine system images 
SYNOPSIS 

/etc/crash [ -d dumpfile ] [ -n namelist ] [ -w outputfile ] 
DESCRIPTION 

The crash command is used to examine the system memory image of a live 
or a crashed system by formatting and printing control structures, tables, 
and other information. Command line arguments to crash are dumpfile, 
namelist, and outputfile, 

Dumpfile is the file containing the system memory image. The default 
dumpfile is /dev/mem. 

The text file namelist contains the symbol table information needed for sym- 
bolic access to the system memory image to be examined. The default 
namelist is /unix. If a system image from another machine is to be exam- 
ined, the corresponding text file must be copied from that machine. 

When the crash command is invoked, a session is initiated. The output from 
a crash session is directed to outputfile. The default outputfile is the stan- 
dard output. 

Input during a crash session is of the form: 

function [argument ... ] 

where function is one of the crash functions described in the FUNCTIONS 
section of this manual page, and arguments are qualifying data that indicate 
which items of the system image are to be printed. 

The default for process-related items is the current process for a running 
system and the process that was running at the time of the crash for a 
crashed system. If the contents of a table are being dumped, the default is 
all active table entries. 

The following function options are available to crash functions wherever 
they are semantically valid. 

-e Display every entry in a table. 

-f Display the full structure. 

-p Interpret all address arguments in the command line as physical 
addresses. 

-s process 

Specify a process slot other than the default, 
-w file Redirect the output of a function to file. 

Note that if the -p option is used, all address and symbol arguments expli- 
citly entered on the command line will be interpreted as physical addresses. 
If they are not physical addresses, results will be inconsistent. 

The functions mode, defproc, and redirect correspond to the function options 
-p, -s, and -w. The mode function may be used to set the address transla- 
tion mode to physical or virtual for all subsequently entered functions; def- 
proc sets the value of the process slot argument for subsequent functions; 



- 1 - 



CRASH(IM) 



(Base System) 



CRASH(IM) 



and redirect redirects all subsequent output. 

Output from crash functions may be piped to another program in the fol- 
lowing way: 

function [argument ... ] ! shelLcommand 

For example, 

mount ! grep rw 

will write all mount table entries with an rw flag to the standard output. 
The redirection option (-w) cannot be used with this feature. 

Depending on the context of the function, numeric arguments will be 
assumed to be in a specific radix. Counts are assumed to be decimal. 
Addresses are always hexadecimal. Table slot arguments are always 
decimal. Table slot arguments larger than the size of the function table will 
not be interpreted correctly. Use the findslot command to translate from an 
address to a table slot number. Default bases on all arguments may be 
overridden. The C conventions for designating the bases of numbers are 
recognized. A number that is usually interpreted as decimal will be inter- 
preted as hexadecimal if it is preceded by Ox and as octal if it is preceded by 
0. Decimal override is designated by Od, and binary by Ob. 

Aliases for functions may be any uniquely identifiable initial substring of 
the function name. Traditional aliases of one letter, such as p for proc, 
remain valid. 

Many functions accept different forms of entry for the same argument. 
Requests for table information will accept a table entry number or a range. 
A range of slot numbers may be specified in the form a-b where a and b are 
decimal numbers. An expression consists of two operands and an operator. 
An operand may be an address, a symbol, or a number; the operator may 
be +, -, *, /, &, or I . An operand which is a number should be preceded 
by a radix prefix if it is not a decimal number (0 for octal. Ox for hexade- 
cimal, Ob for binary). The expression must be enclosed in parentheses (). 
Other functions will accept any of these argument forms that are meaning- 
ful. 

Two abbreviated arguments to crash functions are used throughout. Both 
accept data entered in several forms. They may be expanded into the fol- 
lowing: 

table_entry = table entry! range 
start_addr = address! symbol! expression 

FUNCTIONS 

?[-wfile] 

List available functions. 

!cmd Escape to the shell to execute a command. 

adv [ -e ] [ - w file ] [ [ -p ] table_entry . . . ] 
Print the advertised table. 
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base [-W file] number ... 

Print number in binary, octal, decimal, and hexadecimal. A number 
in a radix other than decimal should be preceded by a prefix that 
indicates its radix as follows: Ox, hexadecimal; 0, octal; and Ob, 
binary. 

buffer [ -w file] [ -format ] bufferslot 
or 

buf f er [ - w file] [-format] [ -p ] start_addr 
Alias: b. 

Print the contents of a buffer in the designated format. The follow- 
ing format designations are recognized: -b, byte: -c, character; -d, 
decimal; -x, hexadecimal; -o, octal; -r, directory; and -i, inode. If 
no format is given, the previous format is used. The default format 
at the beginning of a crash session is hexadecimal. 

bufhdr[-f] [-wfile] [[-p]table_entry ...] 
Alias: buf. 

Print system buffer headers. 

callout [ -w file ] 
Alias: c. 

Print the callout table. 

dballoc [-W file] [class ... ] 

Print the dballoc table. If a class is entered, only data block alloca- 
tion information for that class will be printed. 

dbfree [-w file] [class ... ] 

Print free streams data block headers. If a class is entered, only 
data block headers for the class specified will be printed. 

dblock[-e] [-wfile] [-c class...] 

or 

dblock[-e] [-wfile] [[-p] table_entry ...] 

Print allocated streams data block headers. If the class option (-c) is 
used, only data block headers for the class specified will be printed. 

defproc [ -w file ] [ -c ] 

or 

defproc [-W file] [slot] 

Set the value of the process slot argument. The process slot argu- 
ment may be set to the current slot number (-c) or the slot number 
may be specified. If no argument is entered, the value of the previ- 
ously set slot number is printed. At the start of a crash session, the 
process slot is set to the current process. 

dis [-wfile] [-a] start_addr [count] 

Disassemble from the start address for count instructions. The 
default count is 1. The absolute option (-a) specifies a non- 
symbolic disassembly. 
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ds [-W file] virtual—address ... 

Print the data symbol whose address is closest to, but not greater 
than, the address entered. 

file [ -e ] [ - w file ] [ [ -p ] table_entry ... ] 
Alias: £. 

Print the file table. 

f indaddr [ -w file ] table slot 

Print the address of slot in table. Only tables available to the size 
function are available to findaddr. 

findslot [-W file] virtual—address ... 

Print the table, entry slot number, and offset for the address 
entered. Only tables available to the size function are available to 
findslot. 

f s [ - w file ] [ [ -p ] table— entry . . . ] 

Print the file system information table. 

gdp[-e] [-f] [-wfile] [ [-p] table-entry ...] 
Print the gift descriptor protocol table. 

gdt[-e] [-wfile] [[-p] table— entry ...] 
Print the global descriptor table. 

help [-W file] function ... 

Print a description of the named function, including syntax and 
aliases. 

idt [ -e ] [ - w file ] [ [ -p ] table— entry . . . ] 

Print the interrupt descriptor table. 

inode [ -e ] [ -f ] [ - w f ile ] [ [ -p ] table— entry . . . ] 
Alias: i. 

Print the inode table, including file system switch information. 

kfp [ -w file ] [ value ] 

Print the frame pointer for the start of a kernel stack trace. If the 
value argument is supplied, the kfp is set to that value. 

Ick [ -e ] [ - w file ] [ [ -p ] table— entry . . . ] 
Alias: 1. 

Print record-locking information. If the -e option is used or table 
address arguments are given, the record lock list is printed. If no 
argument is entered, information on locks relative to inodes is 
printed. 

Idt [ -e ] [ - w file ] [ -s process ] [ [ -p ] table— entry . . . ] 

Print the local descriptor table for the given process, or for the 
current process if none is given. 

lmkblk[-e] [-wfile] [ [-p] table-entry ...] 
Print the linkblk table. 

map [-W file] mapname ... 

Print the map structure of mapname. 
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mbfree [-w file] 

Print free streams message block headers. 

mblock [ -e ] [ - w filename ] [ [ -p ] table_entry . . . ] 

Print allocated streams message block headers. 

mode [-W file] [mode] 

Set address translation of arguments to virtual (v) or physical (p) 
mode. If no mode argument is given, the current mode is printed. 
At the start of a crash session, the mode is virtual. 

mount [ -e ] [ - w file ] [ [ -p ] table_entry . . . ] 
Alias: m. 

Print the mount table. 

nm [-W file] symbol ... 

Print value and type for the given symbol. 

od[-p] [-wfile] [-format] [-mode] [ -s process ] start_addr [ count ] 
Alias: rd. 

Print count values starting at the start address in one of the follow- 
ing formats: character (-c), decimal (-d), hexadecimal (-x), octal 
(-o), ASCII (-a), or hexadecimal/character (-h), and one of the fol- 
lowing modes: long (-1), short (-t), or byte (-b). The default mode 
for character and ASCII formats is byte; the default mode for 
decimal, hexadecimal, and octal formats is long. The format -h 
prints both hexadecimal and character representations of the 
addresses dumped; no mode needs to be specified. When format or 
mode is omitted, the previous value is used. At the start of a crash 
session, the format is hexadecimal and the mode is long. If no 
count is entered, 1 is assumed. 

panic 

Print the latest system notices, warnings, and panic messages from 
the limited circular buffer kept in memory. 

pcb [-wfile] [process] 

Print the process control block (TSS) for the given process. If no 
arguments are given, the active TSS for the current process is 
printed. 

pdt[-e] [-wfile] [-s process] [-p] start_addr [count] 

The page descriptor table of the designated memory section and seg- 
ment is printed. Alternatively, the page descriptor table starting at 
the start address for count entries is printed. If no count is entered, 
1 is assumed. 

pf dat [ -e ] [ - w file ] [ [ -p ] table_entry . . . ] 
Print the pfdata table. 

proc[-e][-£] [-wfile] [[-p] table_entry ... #procid ...] 

or 

proc[-f] [-wfile] [-r] 
Alias: p. 

Print the process table. Process table information may be specified 
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in two ways. First, any mixture of table entries and process ids may 
be entered. Each process id must be preceded by a #. Alternatively, 
process table information for executable processes may be specified 
with the executable option (-r). The full option (-f) details most of 
the information in the process table as well as the region table for 
that process. 

qrun [ -w file ] 

Print the list of scheduled streams queues. 

queue [ -e ] [ - w file ] [ [ -p ] table_entry . . . ] 
Print streams queues. 

quit Alias: q. 

Terminate the crash session. 

rcvd[-e] [-f] [-w file] [[-p]table_entry ...] 
Print the receive descriptor table. 

redirect [-W file] [-c] 

or 

redirect [ -w file ] [ file ] 

Used with a file name, redirects output of a crash session to the 
named file. If no argument is given, the file name to which output 
is being redirected is printed. Alternatively, the close option (-c) 
closes the previously set file and redirects output to the standard 
output. 

region [-e] [-wfile] [[-p]table_entry ...] 
Print the region table. 

sdt[-e] [-wfile] [ -s process ] section 

or 

sdt[-e] [-wfile] [-s process] [-p] start_addr[ count] 

The segment descriptor table for the current process is printed. 

search [-p] [-w file] [-m mask] [-s process] pattern start_addr count 

Print the long words in memory that match pattern, beginning at 
the start address for count long words. The mask is anded (&) with 
each memory word and the result compared against the pattern. 
The mask defaults to Oxffffffff . 

size [-W file] [-x] [ structure_name ... ] 

Print the size of the designated structure. The (-x) option prints the 
size in hexadecimal. If no argument is given, a list of the structure 
names for which sizes are available is printed. 

sndd[-e] [-f] [-wfile] [[-p]table_entry ...] 
Print the send descriptor table. 

srmount [ -e ] [ - w file ] [ [ -p ] table_entry . . . ] 
Print the server mount table. 

stack [-W file] [process] 
Alias: s. 
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Dump stack. If no arguments are entered, the kernel stack for the 
current process is printed. The interrupt stack and the stack for the 
current process are not available on a running system. 

Stat [-W file] 

Print system statistics. 

stream [ -e ] [ -f ] [ - w f ile ] [ [ -p ] table_entry . . . ] 
Print the streams table. 

strstat [-W file] 

Print streams statistics. 

trace [-w file] [-r] [process] 
Alias: t. 

Print kernel stack trace. The kfp value is used with the -r option. 

ts [-W file] virtual—address ... 

Print closest text symbol to the designated address. 

tty[-e] [-£] [-wfile] [-ttype[[-p]table_entry ...]] 
Valid types: co, cl, c2 (console, coml, com2). 

Print the tty table. If no arguments are given, the tty table for the 
console is printed. If the -t option is used, the table for the single 
tty type specified is printed. If no argument follows the type 
option, all entries in the table are printed. A single tty entry may be 
specified from the start address. 

user [ -f ] [ -w file ] [ process ] 
Alias: u. 

Print the ublock for the designated process. 

var [-W file] 

Alias: v. 

Print the tunable system parameters. 

vtop [-W file] [-S process] start_addr ... 

Print the physical address translation of the virtual start address. 

FILES 

/dev/mem system image of currently running system 
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NAME 

cron - clock daemon 

SYNOPSIS 

/etc/cron 

DESCRIPTION 

The cron command executes commands at specified dates and times. Regu- 
larly scheduled commands can be specified according to instructions found 
in crontab files in the directory /usr/spool/cron/crontabs. Users can sub- 
mit their own crontab file via the crontab{l) command. Commands which 
are to be executed only once may be submitted via the at{l) command. 

The cron command only examines crontab files and at command files during 
process initialization and when a file changes via crontab or at. This 
reduces the overhead of checking for new or changed files at regularly 
scheduled intervals. 

Since cron never exits, it should be executed only once. This is done rou- 
tinely through /etc/rc2.d/S75cron at system boot time. 
/usr/lib/cron/FIFO is used as a lock file to prevent the execution of more 
than one cron. 

FILES 

/usr/lib/cron 
/usr/lib/cron/FIFO 
/usr /lib /cron /log 
/usr /spool /cron 
/usr /default /cron 

SEE ALSO 

at(l), crontab(l), sh(l). 

DIAGNOSTICS 

To keep a log of all actions taken by cron , set CRONLOG=YES in the file 
/etc/default/cron. No logging is done if you set CRONLOG=NO (default 
setting). Keeping a log is a user-configurable option, cron usually creates 
very large log files. 



main cron directory 
used as a lock file 
accounting information 
spool area 
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NAME 

crontab - user crontab file 

SYNOPSIS 

crontab [file] 
crontab -r 
crontab -1 

DESCRIPTION 

The crontab command copies the specified file, or standard input if no file is 
specified, into a directory that holds all users' crontabs. The -r option 
removes a user's crontab from the crontab directory, crontab -1 will list the 
crontab file for the invoking user. 

Users are permitted to use crontab if their names appear in the file 
/usr/lib/cron/cron.allow. If that file does not exist, the file 
/usr/lib/cron/cron.deny is checked to determine if the user should be 
denied access to crontab. If neither file exists, only root is allowed to submit 
a job. If cron.allow does not exist and cron.deny exists but is empty, glo- 
bal usage is permitted. The allow/deny files consist of one user name per 
line. 

A crontab file consists of lines of six fields each. The fields are separated by 
spaces or tabs. The first five are integer patterns that specify the following: 

minute (0-59), 
hour (0-23), 

day of the month (1-31), 
month of the year (1-12), 
day of the week (0-6 with 0=Sunday). 

Each of these patterns may be either an asterisk (meaning all legal values) 
or a list of elements separated by commas. An element is either a number 
or two numbers separated by a minus sign (meaning an inclusive range). 
Note that the specification of days may be made by two fields (day of the 
month and day of the week). If both are specified as a list of elements, 
both are adhered to. For example, 1,15 * 1 would run a command on 
the first and fifteenth of each month, as well as on every Monday. To 
specify days by only one field, the other field should be set to * (for exam- 
ple, 0**1 would run a command only on Mondays). 

The sixth field of a line in a crontab file is a string that is executed by the 
shell at the specified times. A percent character in this field (unless escaped 
by \) is translated to a new-line character. Only the first line (up to a % or 
end of line) of the command field is executed by the shell. The other lines 
are made available to the command as standard input. 

The shell is invoked from your $HOME directory with an argO of sh. Users 
who desire to have their .profile executed must explicitly do so in the cron- 
tab file. Cron supplies a default environment for every shell, defining 
HOME, LOGNAME, SHELL(=/bin/sh), and 

PATH(=:/bin:/usr/bin:/usr/lbin). 
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If you do not redirect the standard output and standard error of your com- 
mands, any generated output or errors will be mailed to you. 



FILES 



main cron directory 
spool area 

accounting information 
list of allowed users 
list of denied users 



/usr/lib/cron 
/usr /spool /cron /crontabs 
/usr /lib /cron /log 
/usr/lib/cron/cron. allow 
/usr /lib /cron /cron.deny 

SEE ALSO 

cron(lM), sh(l). 

WARNINGS 

If you inadvertently enter the crontab command with no argument(s), do not 
attempt to get out with a CTRL-d. This will cause all entries in your crontab 
file to be removed. Instead, exit with a DEL. 
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NAME 

crypt - encode/decode 

SYNOPSIS 

crypt [ password ] 
crypt [-k] 

DESCRIPTION 

The crypt command reads from the standard input and writes on the stan- 
dard output. The password is a key that selects a particular transformation. 
If no argument is given, crypt demands a key from the terminal and turns 
off printing while the key is being typed in. If the -k option is used, crypt 
will use the key assigned to the environment variable CRYPTKEY, The crypt 
command encrypts and decrypts with the same key: 

crypt key <clear >cypher 
crypt key <cypher | pr 

Files encrypted by crypt are compatible with those treated by the editors 
ed{l), edit{l), ex(l), and vi(l) in encryption mode. 

The security of encrypted files depends on three factors: the fundamental 
method must be hard to solve; direct search of the key space must be 
infeasible; "sneak paths" by which keys or clear text can become visible 
must be minimized. 

The crypt command implements a one-rotor machine designed along the 
lines of the German Enigma, but with a 256-element rotor. Methods of 
attack on such machines are known, but not widely; moreover the amount 
of work required is likely to be large. 

The transformation of a key into the internal settings of the machine is deli- 
berately designed to be expensive, i.e., to take a substantial fraction of a 
second to compute. However, if keys are restricted to (say) three lower-case 
letters, then encrypted files can be read by expending only a substantial 
fraction of five minutes of machine time. 

If the key is an argument to the crypt command, it is potentially visible to 
users executing ps(l) or a derivative. The choice of keys and key security 
are the most vulnerable aspect of crypt. 

FILES 

/dev/tty for typed key 

SEE ALSO 

ed(l), edit(l), ex(l), makekey(l), ps(l), stty(l), vi(l). 
WARNING 

This command is provided with the Security Administration Utilities, which 
is only available in the United States. If two or more files encrypted with 
the same key are concatenated and an attempt is made to decrypt the result, 
only the contents of the first of the original files will be decrypted correctly. 
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NAME 

csh - invoke a shell command interpreter that uses C-like syntax 

SYNOPSIS 

csh [ -cefinstvVxX ] [ arg ... ] 

DESCRIPTION 

csh is a command language interpreter. It begins by executing commands 
from the file .cshrc in the home directory of the invoker. If this is a login 
shell, then it also executes commands from the file .login there. In the nor- 
mal case, the shell will then begin reading commands from the terminal, 
prompting with %. Processing of arguments and the use of the shell to pro- 
cess files containing command scripts will be described later. 

The shell then repeatedly performs the following actions: a line of com- 
mand input is read and broken into words. This sequence of words is 
placed on the command history list and then parsed. Finally, each com- 
mand in the current line is executed. 

When a login shell terminates, it executes commands from the file .logout 
in the user's home directory. 

Lexical structure 

The shell splits input lines into words at blanks and tabs with the following 
exceptions. The characters &, !, ;, <, >, (, and ) form separate words. If 
doubled (for example, &&, 1 1, «, or ») these character pairs form single 
words. These parser metacharacters may be made part of other words, or 
you can take away their special meaning by preceding them with \. A 
newline preceded by a \ is equivalent to a blank. 

In addition, strings enclosed in matched pairs of quotations, ', 'or form 
parts of a word; metacharacters in these strings, including blanks and tabs, 
do not form separate words. The semantics of these quotations are 
described below. Within pairs of \ or " characters, a newline preceded by a 
\ gives a true newline character. 

When the shell's input is not from the console, the character # introduces a 
comment which continues to the end of the input line. It does not have 
this special meaning when preceded by \ and placed inside the quotation 
marks ', and " . 

Commands 

A simple command is a sequence of words, the first of which specifies the 
command to be executed. A simple command or a sequence of simple com- 
mands separated by I characters forms a pipeline. The output of each com- 
mand in a pipeline is connected to the input of the next. Sequences of pipe- 
lines may be separated by a semicolon (;) and are then executed sequen- 
tially. A sequence of pipeline commands may be executed without waiting 
for them to terminate by following it with an &. Such a sequence is 
automatically prevented from being terminated by a hangup signal; the 
nohup command need not be used. 

Any of the above may be placed in parentheses to form a simple command, 
which may be a component of a pipeline, etc. It is also possible to separate 
pipelines with 1 1 or && indicating, as in the C language, that the second is 
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to be executed only if the first fails or succeeds respectively. (See Expres- 
sions.) 

Substitutions 

The following sections describe the various transformations the shell per- 
fonns on the input in the order in which they occur. 

History Substitutions 

History substitutions can be used to reintroduce sequences of words from 
previous commands, possibly performing modifications on these words. 
Thus, history substitutions provide a generalization of a redo function. 

History substitutions begin with the ! character and may begin anywhere in 
the input stream if a history substitution is not already in progress. This ! 
may be preceded by a \ to prevent its special meaning; a ! is passed 
unchanged when it is followed by a blank, tab, newline, =, or (. History 
substitutions also occur when an input line begins with . This special 
abbreviation will be described later. 

Any input line that contains a history substitution is echoed on the terminal 
before it is executed as it could have been typed without a history substitu- 
tion. 

Commands input from the terminal that consist of one or more words are 
saved on the history list, the size of which is controlled by the history vari- 
able. The previous command is always retained. Commands are numbered 
sequentially from 1. 

For example, consider the following output from the history command: 

9 write michael 

10 ex write. c 

11 cat oldwrite.c 

12 diff *write.c 

The commands are shown with their event numbers. It is not usually 
necessary to use event numbers, but the current event number can be made 
part of the prompt by placing a ! in the prompt string. 

With the current event 13, we can refer to previous events by event number 
111, relatively as in !-2 (referring to the same event), by a prefix of a com- 
mand word as in !d for event 12 or !w for event 9, or by a string contained 
in a word in the command as in !?mic? also referring to event 9. These 
forms, without further modification, simply re-introduce the words of the 
specified events, each separated by a single blank. As a special case, !! 
refers to the previous command; thus, !! alone is essentially a redo. The 
form !# references the current command (the one being typed in). It allows 
a word to be selected from further left in the line, to avoid retyping a long 
name, as in !#:1. 

To select words from an event, we can follow the event specification by a : 
and a designator for the desired words. The words of an input line are 
numbered from 0, the first (usually command) word being 0, the second 
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word (first argument) being 1, and so on. The basic word designators are as 
follows: 



Designator 


Description 





First (command) word 


n 


nth argument 




First argument, i.e., 1 


$ 


Last argument 


% 


Word matched by (immediately preceding) ?s ? search 




Range of words 


-y 


Abbreviates 0-y 


* 


Abbreviates -$, or nothing if only one word in event 


X* 


Abbreviates x-$ 


X- 


Like X* but omitting word $ 



The colon separating the event specification from the word designator can 
be omitted if the argument selector begins with a t/ $/ */ - or %• After the 
optional word designator, a sequence of modifiers can be placed, each pre- 
ceded by a :. The following modifiers are defined: 



Modifier Description 

h Removes a trailing pathname component 

r Removes a trailing .xxx component 

s/l/r / Substitutes / for r 

t Removes all leading pathname components 

& Repeats the previous substitution 

g Applies the change globally, prefixing the above 

p Prints the new command but does not execute it 

q Quotes the substituted words, preventing substitutions 

X Like q but breaks into words at blanks, tabs, and newlines 



Unless preceded by a g, the modification is applied only to the first modifi- 
able word. In any case, it is an error for no word to be applicable. 

The left side of substitutions are not regular expressions in the sense of the 
editors but rather strings. Any character may be used as the delimiter in 
place of /; a \ quotes the delimiter into the / and r strings. The character & 
in the right side is replaced by the text from the left. A \ quotes & also. A 
null / uses the previous string either from a / or from a contextual scan 
string s in !?s ?. The trailing delimiter in the substitution may be omitted if a 
newline follows immediately as may the trailing ? in a contextual scan. 

A history reference may be given without an event specification, e.g., !$. In 
this case the reference is to the previous command unless a previous history 
reference occurred on the sarne line, in which case this form repeats the pre- 
vious reference. Thus, !?foo?'!$ gives the first and last arguments from the 
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command matching ?foo?. 

A special abbreviation of a history reference occurs when the first nonblank 
character of an input line is a . This is equivalent to !:s , providing a con- 
venient shorthand for substitutions on the text of the previous line. Thus, 
lb lib fixes the spelling of lib in the previous command. Finally, a history 
substitution may be surrounded with { and } if necessary to insulate it from 
the characters that follow. Thus, after Is -Id 'paul we might do !{l}a to do 
Is -Id "paula, while !la would look for a command starting la. 

Quotations With ' and " 

The quotation of strings by ' and " can be used to prevent all or some of 
the remaining substitutions. Strings enclosed in ' are prevented from any 
further interpretation. Strings enclosed in " are variable, and command 
expansion may occur. 

In both cases, the resulting text becomes (all or part of) a single word; only 
in one special case (see Command Substitution below) does a " quoted string 
yield parts of more than one word; ' quoted strings never do. 

Alias Substitution 

The shell maintains a list of aliases that can be established, displayed, and 
modified by the alias and unalias commands. After a command line is 
scanned, it is parsed into distinct commands, and the first word of each 
command, left-to-right, is checked to see if it has an alias. If it does, then 
the text which is the alias for that command is reread with the history 
mechanism available as though that command were the previous input line. 
The resulting words replace the command and argument list. If no refer- 
ence is made to the history list, then the argument list is left unchanged. 

Thus, if the alias for Is is Is -1, the command "Is /usr" would map to 'Is -1 
/usr". Similarly if the alias for lookup was "grep !^ /etc/passwd", then 
"lookup bill" would map to "grep bill /etc/passwd". 

If an alias is found, the word transformation of the input text is performed 
and the aliasing process begins again on the reformed input line. Looping 
is prevented if the first word of the new text is the same as the old by flag- 
ging it to prevent further aliasing. Other loops are detected and cause an 
error. 

Note that the mechanism allows aliases to introduce parser metasyntax. 
Thus, you can alias print "'pr \!* I Ipr'" to make a command that paginates 
its arguments to the lineprinter. 

Variable Substitution 

The shell maintains a set of variables, each of which has as value zero or 
more words. Some of these variables are set by the shell or referred to by 
it. For instance, the argv variable is an image of the shell's argument list, 
and words of this variable's value are referred to in special ways. 

The values of variables may be displayed and changed by using the set and 
unset commands. Of the variables referred to by the shell, a number are 
toggles; the shell does not care what their value is, only whether they are 
set or not. For instance, the verbose variable is a toggle that causes com- 
mand input to be echoed. The setting of this variable results from the -v 
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command line option. 

Other operations treat variables numerically. The at-sign (@) command 
permits numeric calculations to be performed and the result assigned to a 
variable. However, variable values are always represented as (zero or more) 
strings. For the purposes of numeric operations, the null string is con- 
sidered to be zero, and the second and subsequent words of multiword 
values are ignored. 

After the input line is aliased and parsed, and before each command is exe- 
cuted, variable substitution is performed, keyed by dollar sign ($) characters. 
This expansion can be prevented by preceding the dollar sign with a 
backslash (\) except within double quotation marks (") where it always 
occurs, and within single quotation marks (') where it never occurs. Strings 
quoted by back quotation marks (') are interpreted later (see Command Sub- 
stitution below) so dollar sign substitution does not occur there until later, if 
at all. A dollar sign is passed unchanged if followed by a blank, tab, or 
end-of-line. 

Input and output redirections are recognized before variable expansion and 
are expanded separately. Otherwise, the command name and entire argu- 
ment list are expanded together. It is thus possible for the first (command) 
word to generate more than one word, the first of which becomes the com- 
mand name, and the rest of which become arguments. 

Unless enclosed in double quotation marks or given the :q modifier, the 
results of variable substitution may eventually be command and filename 
substituted. Within double quotation marks (") a variable whose value 
consists of multiple words expands to a portion of a single word, with the 
words of the variable's value separated by blanks. When the :q modifier is 
applied to a substitution, the variable expands to multiple words with each 
word separated by a blank and quoted to prevent later command or 
filename substitution. 

The following sequences are provided for introducing variable values into 
the shell input. Except as noted, it is an error to reference a variable that is 
not set. 

$name 
${name} 

Are replaced by the words of the value of variable name, each 
separated by a blank. Braces insulate name from following characters 
which would otherwise be part of it. Shell variables have names con- 
sisting of up to 20 letters, digits, and underscores. 

If name is not a shell variable, but is set in the environment, then that 
value is returned. However, modifiers and the other forms shown in 
the following list are not available in this case. 

$name[selector] 
${name[selector]} 

May be used to select only some of the words from the value of name. 
The selector is subjected to $ substitution and may consist of a single 
number or two numbers separated by a -. The first word of a variable 
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value is numbered 1. If the first number of a range is omitted, it 
defaults to 1. If the last member of a range is omitted, it defaults to 
$#name. The selector * selects all words. It is not an error for a range 
to be empty if the second argument is omitted or in range. 

$#name 
${#«flme} 

Gives the number of words in the variable. This is useful for later use 
in a [selector]. 

$0 

Substitutes the name of the file from which command input is being 
read. An error occurs if the name is not known. 

$number 
${number} 

Equivalent to $argv[number]. 

$* Equivalent to $argv[*]. 

The modifiers :h, :t, :r, :q and :x may be applied to the substitutions above 
as may :gh, :gt and :gr. If braces { } appear in the command form, then the 
modifiers must appear within the braces. Only one : modifier is allowed on 
each $ expansion. 

The following substitutions may not be modified with : modifiers. 

$7name 
${?name} 

Substitutes the string 1 if name is set and if it is not. 
$?0 Substitutes 1 if the current input filename is known and if it is not. 
$$ Substitutes the (decimal) process number of the (parent) shell. 

Command and Filename Substitution 

Command and filename substitution are applied selectively to the argu- 
ments of built-in commands. This means that portions of expressions that 
are not evaluated are not subjected to these expansions. For commands that 
are not internal to the shell, the command name is substituted separately 
from the argument list. This occurs very late, after input-output redirection 
is performed, and in a child of the main shell. 

Command Substitution 

Command substitution is indicated by a command enclosed in back quota- 
tion marks. The output from such a command is normally broken into 
separate words at blanks, tabs, and newlines, with null words being dis- 
carded. This text then replaces the original string. Within double quotation 
marks, only newlines force new words; blanks and tabs are preserved. 

In any case, the single final newline does not force a new word. Note that 
it is thus possible for a command substitution to yield only part of a word, 
even if the command displays a complete line. 

Filename Substitution 

If a word contains any *, ?, [ or { characters, or begins with the character 
then that word is a candidate for filename substitution, also known as 
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globbing. This word is then regarded as a pattern and is replaced with an 
alphabetically sorted list of filenames that match the pattern. In a list of 
words specifying filename substitution, it is an error for no pattern to match 
an existing filename, but it is not required for each pattern to match. Only 
the metacharacters *, ?, and [ imply pattern matching; the characters " and { 
are more akin to abbreviations. 

In matching filenames, the . character at the beginning of a filename or 
immediately following a /, as well as the character /, must be matched 
explicitly. The * character matches any string of characters, including the 
null string. The ? character matches any single character. The sequence [...] 
matches any one of the characters enclosed. Within [...], a pair of characters 
separated by - matches any character lexically between the two. 

The " character at the beginning of a filename is used to refer to home 
directories. Standing alone it expands to the invoker's home directory as 
reflected in the value of the variable home. When followed by a name con- 
sisting of letters, digits, and - characters, the shell searches for a user with 
that name and substitutes the user's home directory; thus, "ken might 
expand to /usr/ken and ""ken/chmach to /usr/ken/chmach. If the " char- 
acter is followed by a character other than a letter or /, or does not appear 
at the beginning of a word, it is left unchanged. 

The metanotation a{b,c,d}e is a shorthand for abe ace ade. Left to right 
order is preserved, with results of matches being sorted separately at a low 
level to preserve this order. This construct may be nested. Thus, 
"source/sl/{oldls,ls}.c expands to /usr/source/sl/oldls.c 
/usr/source/sl/ls.c, whether or not these files exist, without any chance of 
error if the home directory for source is /usr/source. Similarly 
../{memo,*box} might expand to ../memo ../box ../mbox. (Note that 
memo was not sorted with the results of matching *box.) As a special case 
{, }, and {} are passed unchanged. 

Input/Output 

The standard input and standard output of a command may be redirected 
with the following syntax: 

< name 

Opens file name (which is first variable, command and filename 
expanded) as the standard input. 

« word 

Reads the shell input up to a line which is identical to word, word is 
not subjected to variable, filename, or command substitution, and each 
input line is compared to word before any substitutions are made on 
this input line. Unless a quoting backslash, double or single quotation 
mark, or a back quotation mark appears in word, variable and com- 
mand substitution is performed on the intervening lines, allowing \ to 
quote $, \ and \ Commands that are substituted have all blanks, tabs, 
and newlines preserved except for the final newline, which is dropped. 
The resulting text is placed in an anonymous temporary file, which is 
given to the command as standard input. 
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> name 
>! name 
>& name 
>&! name 

The file name is used as standard output. If the file does not exist, 
then it is created; if the file exists, it is truncated, and its previous con- 
tents are lost. 

If the variable noclobher is set, then the file must not already exist or it 
must be a character special file (e.g., a terminal or /dev/null), or an 
error results. This helps prevent accidental destruction of files. In this 
case, the ! forms can be used to suppress this check. 

The forms involving & route the diagnostic output into the specified 
file as well as the standard output, name is expanded in the same way 
as < input filenames are. 

» name 
»& name 
»! name 
»&! name 

Uses file name as standard output like > but places output at the end 
of the file. If the variable noclobher is set, then it is an error for the file 
not to exist unless one of the ! forms is given. Otherwise, it is similar 
to >. 

If a command is run detached (followed by &), then the default standard 
input for the command is the empty file /dev/null. Otherwise, the com- 
mand receives the environment in which the shell was invoked as modified 
by the input-output parameters and the presence of the command in a pipe- 
line. Thus, unlike some previous shells, commands run from a file of shell 
commands have no access to the text of the commands by default; rather 
they receive the original standard input of the shell. The « mechanism 
should be used to present inline data. This permits shell command scripts 
to function as components of pipelines and allows the shell to block read its 
input. 

Diagnostic output may be directed through a pipe with the standard output. 
Simply use the form I & rather than just I. 

Expressions 

A number of the built-in commands (to be described later) take expressions, 
in which the operators are similar to those of C, with the same precedence. 
These expressions appear in the @, exit, if, and while commands. The fol- 
lowing operators are available: 

1 1 && I ^ &==!=<=>=<> « » 

+ -*/%!"() 
Here the precedence increases to the right, with the following operators 
forming groups at the same level: 

== and != 

<=, >=, <, and > 

« and » 
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+ and - 
* / and % 

The == and != operators compare their arguments as strings; all others 
operate on numbers. Strings that begin with are considered octal 
numbers. Null or missing arguments are considered 0. The result of all 
expressions are strings, which represent decimal numbers. It is important to 
note that no two components of an expression can appear in the same 
word; they should be surrounded by spaces except when adjacent to com- 
ponents of expressions which are syntactically significant to the parser [& I 
<>()]. 

Also available in expressions as primitive operands are command executions 
enclosed in { and } and file enquiries of the form -/ name, where / is one of 
the following characters: 



r 


read access 


w 


write access 


X 


execute access 


e 


existence 


o 


ownership 


z 


zero size 


f 


plain file 


d 


directory 



The specified name is command- and filename-expanded, then tested to see 
if it has the specified relationship to the real user. If the file does not exist 
or is inaccessible, then all enquiries return false, i.e., 0. Command execu- 
tions succeed, returning true, i.e., 1, if the command exits with status 0; oth- 
erwise, they fail, returning false, i.e., 0. If more detailed status information 
is required, then the command should be executed outside of an expression 
and the variable status examined. 

Control Flow 

The shell contains a number of commands that can be used to control com- 
mand files (shell scripts) and, in limited but useful ways, terminal input. 
These commands all operate by forcing the shell to reread or skip in its 
input and, due to the implementation, restrict the placement of some of the 
commands. 

The foreach, switch, and while statements, as well as the if-then-else form of 
the if statement, require that the major keywords appear in a single com- 
mand line. 

If the shell's input is not seekable, the shell buffers up input whenever a 
loop is being read and perform seeks in this internal buffer to accomplish 
the rereading implied by the loop. (To the extent that this allows, backward 
goto commands will succeed on nonseekable inputs.) 

Built-in Commands 

Built-in commands are executed within the shell. If a built-in command 
occurs as any component of a pipeline except the last, then it is executed in 
a subshell. The following list describes the syntax and function of the 
built-in commands: 
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alias 

alias name 

alias name ivordlist 

The first form prints all aliases. The second form prints the alias for 
name. The final form assigns the specified wordlist as the alias of 
name; wordlist is command and filename substituted, name is not 
allowed to be alias or unalias. 

break . . , i • 

Causes execution to resume after the end of the nearest enclosmg 
foreach or while statement. The remaining commands on the current 
line are executed. Multilevel breaks are thus possible by writing them 
all on one line, 
breaks w 

Causes a break from a switch, resuming after the endsw, 
case label: 

A label in a switch statement as discussed below. 

cd 

cd name 
chdir 

chdir name ^. 

Changes the shell's working directory to directory name. If no argu- 
ment is given, then it changes to the home directory of the user. If 
name is not found as a subdirectory of the current directory (and does 
not begin with /, ./, or ../), then each component of the variable 
cdpath is checked to see if it has a subdirectory name. Finally, if all 
else fails but name is a shell variable whose value begins with / , then 
this is tried to see if it is a directory. 

continue , 

Continues execution of the nearest enclosing while or foreach. The rest 
of the commands on the current line are executed. 

default: j r li. u u 

Labels the default case in a switch statement. The default should 

come after all case labels, 
echo wordlist 

The specified words are written to the shell's standard output. A \c 
causes the echo to complete without printing a newline. A \n in 
wordlist causes a newline to be printed. Otherwise, the words are 
echoed, separated by spaces. 

else 
end 
endif 

endsw ^ . , ,71 

See the following descriptions of the foreach, if, switch, and while 

statements. 
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exec command 

The specified command is executed in place of the current shell. 

exit 

exit (expr) 

The shell exits either with the value of the status variable (first form) 
or with the value of the specified expr (second form), 
foreach name (wordlist) 

end 

The variable name is successively set to each member of wordlist and 
the sequence of commands between this command and the matching 
end are executed. (Both foreach and end must appear alone on 
separate lines.) 

The built-in command continue may be used to continue the loop 
prematurely, and the built-in command break may be used to ter- 
minate it prematurely. When this command is read from the terminal, 
the loop is read up once prompting with ? before any statements in 
the loop are executed. 

glob wordlist 

Like echo but no \ escapes are recognized and words are delimited by 
null characters in the output. Useful for programs that wish to use the 
shell to filename-expand a list of words, 
goto word 

The specified word is filename-and-command expanded to yield a 
string of the form label. The shell rewinds its input as much as possi- 
ble and searches for a line of the form label: possibly preceded by 
blanks or tabs. Execution continues after the specified line, 
history 

Displays the history event list, 
if (expr) command 

If the specified expression evaluates true, then the single command 
with arguments is executed. Variable substitution on command hap- 
pens early, at the same time it does for the rest of the if command. 
Command must be a simple command, not a pipeline, a command list, 
or a parenthesized command list. Input/output redirection occurs 
even if expr is false, when command is not executed, 
if (expr) then 

else if (exprl) then 

else 

endif 

If the specified expr is true, then the commands to the first else are 
executed; else if exprl is true, then the commands to the second else 
are executed, etc. Any number of else-if pairs are possible; only one 
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endif is needed. The else part is likewise optional. (The words else 
and endif must appear at the beginning of input lines; the if must 
appear alone on its input line or after an else.) 

logout 

Terminates a login shell. The only way to log out if ignoreeof is set. 

nice 

nice +number 

nice command 

nice -\-number command 

The first form sets the nice for this shell to 4. The second form sets 
the nice to the given number. The final two forms run command at 
priority 4 and number respectively. The super-user may specify nega- 
tive niceness by using "nice -number The command is always 
executed in a subshell, and the restrictions placed on commands in 
simple if statements apply. 

nohup 

nohup command 

The first form can be used in shell scripts to cause hangups to be 
ignored for the remainder of the script. The second form causes the 
specified command to be run with hangups ignored. Unless the shell is 
running detached, nohup has no effect. All processes detached with & 
are automatically run with nohup, (Thus nohup is not really needed.) 

onintr 
onintr - 
onintr label 

Controls the action of the shell on interrupts. The first form restores 
the default action of the shell on interrupts: to terminate shell scripts 
or to return to the terminal command input level. The second form 
onintr - causes all interrupts to be ignored. The final form causes the 
shell to execute a goto label when an interrupt is received or a child 
process terminates because it was interrupted. 

In any case, if the shell is running detached and interrupts are being 
ignored, all forms of onintr have no meaning, and interrupts continue 
to be ignored by the shell and all invoked commands. 
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rehash 

Causes the internal hash table of the directories' contents in the path 
variable to be recomputed. This is needed if new commands are 
added to directories in the path while you are logged in. This should 
be necessary only if you add commands to one of your own direc- 
tories or if a systems programmer changes the contents of one of the 
system directories. 

repeat count command 

The specified command, which is subject to the same restrictions as the 
command in the one line if statement above, is executed count times. 
I/O redirections occurs exactly once, even if count is 0. 

set 

set name 

set name=word 

set name[index]=word 

set name=(wordlist) 

The first form of the command shows the value of all shell variables. 
Variables that have other than a single word as value print as a 
parenthesized word list. The second form sets name to the null string. 
The third form sets name to the single word. The fourth form sets the 
index component of name to word; this component must already exist. 
The final form sets name to the list of words in wordlist. In all cases 
the value is command- and filename-expanded. These arguments may 
be repeated to set multiple values in a single set command. Note, 
however, that variable expansion happens for all arguments before 
any setting occurs. 

setenv name value 

Sets the value of the environment variable name to be value, a single 
string. Useful environment variables are TERM , the type of your ter- 
minal and SHELL , the shell you are using. 

shift 

shift variable 

The members of argv are shifted to the left, discarding argv[l]. It is an 
error for argv not to be set or to have less than one word as value. 
The second form performs the same function on the specified variable, 
source name 

The shell reads commands from name, source commands may be 
nested; if they are nested too deeply, the shell may run out of file 
descriptors. An error in a source at any level terminates all nested 
source commands. Input during source commands is never placed on 
the history list. 
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switch (string) 
case strl: 

breaksw 

default: 

breaksw 
endsw 

Each case label is successively matched against the specified string that 
is first command- and filename-expanded. The file metacharacters *, ?, 
and f 1 may be used in the case labels, which are variable-expanded. 
If none of the labels match before a default label is found, then the 
execution begins after the default label. Each case label and the 
default label must appear at the beginning of a line. The command 
breaksw causes execution to continue after the endsw. Otherwise con- 
trol may fall through case labels and default labels, as m C. If no 
label matches and there is no default, execution continues after the 
endsw . 

time 

time command , 
With no argument, a summary of time used by this shell and its chil- 
dren is printed. If arguments are given, the specified simple command 
is timed, and a time summary as described under the time variable is 
printed. If necessary, an extra shell is created to print the time statistic 
when the command completes. 

umask 

umask value , . x . . a^A 

The file creation mask is displayed (first form) or set to the specified 
value (second form). The mask is given in octal. Common values for 
the mask are 002, giving all access to the group and read and execute 
access to others; or 022, giving all access except no wnte access for 
users in the group or others. 

unalias pattern . 
All aliases whose names match the speafied pattern are discarded. 
Thus, all aliases are removed by unalias *. It is not an error for noth- 
ing to match the unalias pattern. 

unhash , . r . j 

Use of the internal hash table to speed location of executed programs 

is disabled. 

unset pattern .r. ^ a 

All variables whose names match the specified pattern are removed. 
Thus, all variables are removed by unset *; this has noticeably undesir- 
able side-effects. It is not an error for nothing to be unset. 

All child processes are waited for. It the shell is interactive, then an 
interrupt can disrupt the wait, at which time the shell prints names 
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and process numbers of all children known to be outstanding. 
while(e:c;7r) 

end 

While the specified expression evaluates nonzero, the commands 
between the while and the matching end are evaluated. Break and 
continue may be used to terminate or continue the loop prematurely. 
(The while and end must appear alone on their input lines.) Prompt- 
ing occurs here the first time through the loop as for the foreach state- 
ment if the input is a terminal. 

@ 

@ name = expr 

@ name [ index ] = expr 

The first form prints the values of all the shell variables. The second 
form sets the specified name to the value of expr. If the expression 
contains <, >, & or I, then at least this part of the expression must be 
placed within ( ). The third form assigns the value of expr to the index 
argument of name. Both name and its index component must already 
exist. 

Assignment operators, such as *= and +=, are available as in C. The 
space separating the name from the assignment operator is optional. 
Spaces are mandatory in separating components of expr which would 
otherwise be single words. 

Special postfix and operators increment and decrement name 

respectively, i.e., @ i4-+. 

Predefined Variables 

The following variables have special meaning to the shell. Of these, argv, 
child, home, path, prompt, shell, and status are always set by the shell 
Except for child and status, this setting occurs only at initialization; these 
variables will not then be modified unless done explicitly by the user. 
Variable Description 

argv Set to the arguments of the shell; from this variable, posi- 

tional parameters are substituted, i.e., $1 is replaced by 
$argv[l]. 

cdpath Gives a list of alternate directories searched to find sub- 

directories in cd commands. 

child The process number printed when the last command was 

forked with &. This variable is unset when this process ter- 
minates. 

echo Set when the -x command line option is given. Causes 

each command and its arguments to be echoed just before 
it is executed. For nonbuilt-in commands, all expansions 
occur before echoing. Built-in commands are echoed before 
command and filename substitution since these substitu- 
tions are then done selectively. 
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histchars Can be assigned a two-character string. The first character 

is used as a history character in place of !; the second char- 
acter is used in place of the ^ substitution mechanism. For 
example, set histchars = will cause the history characters 
to be comma and semicolon. 

history Can be given a numeric value to control the size of the his- 

tory list. Any command that has been referenced in this 
many events will not be discarded. A history that is too 
large may run the shell out of memory. The last executed 
command is always saved on the history list. 

home The home directory of the user, initialized from the 

environment. The filename expansion of " refers to this 
variable. 

ignoreeof If set, the shell ignores the end-of-file from input devices 
that are terminals. This prevents a shell from accidentally 
being terminated by typing a CTRL-D. 

mail The files where the shell checks for mail. This is done after 

each command completion results in a prompt, if a speci- 
fied interval has elapsed. The shell sends the message 
"You have new mail'' if the file exists with an access time 
not greater than its modify time. If the first word of the 
value of mail is numeric, it specifies a different mail check- 
ing interval, in seconds, than the default, which is 10 
minutes. If multiple mail files are specified, then the shell 
sends the message "New mail in name" when there is mail 
in the file name. 

noclobber Restrictions are placed on output redirection to insure that 
files are not accidentally destroyed and that » redirections 
refer to existing files. 

noglob If set, filename expansion is inhibited. This is most useful 

in shell scripts that are not dealing with filenames or after a 
list of filenames has been obtained and further expansions 
are not desirable. 

nomatch If set, it is not an error for a filename expansion to not 

match any existing files; rather, the primitive pattern is 
returned. It is still an error for the primitive pattern to be 
malformed, i.e., echo [ still gives an error. 

path Each word of the path variable specifies a directory in 

which commands are to be sought for execution. A null 
word specifies the current directory. If there is no path 
variable, then only full pathnames will execute. The usual 
search path is /bin, /usr/bin, and ., but this may vary 
from system to system. For the super-user, the default 
search path is /etc, /bin and /usr/bin. A shell that is 
given neither the -c nor the -t option will normally hash 
the contents of the directories in the path variable after 
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reading .cshrc and each time the path variable is reset. If 
new commands are added to these directories while the 
shell is active, it may be necessary to give the rehash, or 
the commands may not be found. 

The string that is printed before each command is read 
from an interactive terminal input. If a ! appears in the 
string it will be replaced by the current event number 
unless a preceding \ is given. The default is % or # for the 
super-user. 

The file in which the shell resides. This is used in forking 
shells to interpret files that have execute bits set but are not 
executable by the system. (See the section Nonbuilt-In 
Command Execution below.) shell is initialized to the 
system-dependent home of the shell. 

The status returned by the last command. If it terminated 
abnormally, then 0200 is added to the status. Abnormal 
termination results in a core dump. Built-in commands that 
fail return exit status 1; all other built-in commands set 
status 0. 

Controls automatic timing of commands. If set, then any 
command that takes more than this many CPU seconds will 
cause a line giving user, system, and real times and a utili- 
zation percentage (ratio of user plus system times to real 
time) to be printed when it terminates. 

Set by the -v command line option, causes the words of 
each command to be printed after history substitution. 
The shell copies the environment variable PATH into the variable path and 
copies the value back into the environment whenever path is set. Thus, it is 
not necessary to worry about its setting other than in the file .cshrc as infe- 
rior csh processes will import the definition of path from the environment. 
Nonbuilt-In Command Execution 

When a command to be executed is found to not be a built-in command, 
the shell attempts to execute the command via exec{S). Each word in the 
variable path names a directory from which the shell will attempt to execute 
the command. If it is given neither a -c nor a -t option, the shell will hash 
the names in these directories into an internal table so that it will only try 
an exec in a directory if there is a possibility that the command resides 
there. This greatly speeds command location when a large number of direc- 
tories are present in the search path. If this mechanism has been turned off 
(via unhash) or if the shell was given a -c or -t argument, and in any case 
for each directory component of path which does not begin with a /, the 
shell concatenates with the given command name to form a pathname of a 
file which it then attempts to execute. 

Parenthesized commands are always executed in a subshell. Thus (cd ; 
pwd) ; pwd prints the home directory, leaving you where you were (printing 
this after the home directory), while cd ; pwd leaves you in the home 
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directory. Parenthesized commands are most often used to prevent cd from 
affecting the current shell. 

If the file has execute permissions but is not an executable binary to the sys- 
tem, then it is assumed to be a file containing shell commands and a new 
shell is spawned to read it. 

If there is an alias for shell, then the words of the alias will be prepended to 
the argument list to form the shell command. The first word of the alias 
should be the full pathname of the shell (e.g., $shell). Note that this is a 
special, late occurring case of alias substitution and only allows words to be 
prepended to the argument list without modification. 

Argument List Processing 

If argument to the shell is -, then this is a login shell. The flag arguments 
are interpreted as follows: 

Flag Description 

-c Reads commands from the (single) following argument which must 
be present. Any remaining arguments are placed in argv. 

-e Causes the shell to exit if any invoked command terminates abnor- 
mally or yields a nonzero exit status. 

-f Lets the shell start faster because it will neither search for nor exe- 
cute commands from the file .cshrc in the user's home directory. 

-i Makes the shell interactive. The shell prompts for its top-level input 
even if it appears not to be a terminal. Shells are interactive without 
this option if their inputs and outputs are terminals. 

-n Causes commands to be parsed but not executed. This may aid in 
syntactic checking of shell scripts. 

-s Causes command input to be taken from the standard input. 

-t Reads and executes a single line of input. A backslash (\) can be 
used to escape the newline at the end of this line and continue onto 
another line. 

-V Causes the verbose variable to be set, with the effect that command 
input is echoed after history substitution. 

-X Causes the echo variable to be set so that commands are echoed 
immediately before execution. 

-V Causes the verbose variable to be set even before .cshrc is executed. 

-X Causes the echo variable to be set even before .cshrc is executed. 

After processing of flag arguments, if arguments remain but none of the -c, 
-i, -s, or -t options were given, the first argument is taken as the name of a 
file of commands to be executed. The shell opens this file and saves its 
name for possible resubstitution by $0. Since on a typical system most shell 
scripts are written for the standard shell [see sh(C)], the C shell will execute 
such a standard shell if the first character of a script is not a #, i.e., if the 
script does not start with a comment. Remaining arguments initialize the 
variable argv. 
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Signal Handling 

The shell normally ignores quit signals. The interrupt and quit signals are 
ignored for an invoked command if the command is followed by &; other- 
wise, the signals have the values that the shell inherited from its parent. 
The shell's handling of interrupts can be controlled by onintr. Login shells 
catch the terminate signal; otherwise, this signal is passed on to children 
from the state in the shell's parent. In no case are interrupts allowed when 
a login shell is reading the file .logout. 

NEW ENVIRONMENT VARIABLES 

The new environment variable described in this section has been added to 
the C shell. The C shell will behave normally for those users who do not 
set DOSPATH. Users who wish to be able to execute DOS programs 
directly from the C shell, that is, bypassing the normal DOS bootup that 
occurs when running vpix, should set DOSPATH to include those direc- 
tories in PATH that contain DOS executables. 

DOSPATH is a string with the same format as PATH; it contains a subset 
of the list of directories from PATH. When searching a directory in PATH 
for a program, the C shell determines whether that directory is also in 
DOSPATH. If it is not, the C shell acts as usual. If it is, the C shell looks 
first for the command with the suffix .com, then .exe, then .bat, and finally, 
for the command without any suffix. Whenever the result of a path search 
gives a file with one of these DOS suffixes, the shell runs the vpix program 
via a standard search path and adds arguments -c and the full path name of 
the DOS program (including the suffix). 

For example, if PATH is set to :/bin:/usr/bin, DOSPATH is set to ., the 
current directory is /usr/john/dosbin, and there is a DOS program named 
abc.comi in the current directory, then typing abc to the C shell will cause 
the command vpix -c /usr/john/dosbin/ abc.com to be executed, which will 
run the DOS program abc.com without the normal vpix DOS bootup. 

FILES 

'/.cshrc Read by each shell at the beginning of execution 

"/.login Read by login shell after .cshrc at login 

""/.logout Read by login shell at logout 
/bin/sh Shell for scripts not starting with a # 

/tmp/sh* Temporary file for « 
/dev/null Source of empty file 
/ etc/passwd Source of home directories for "name 
/etc/cshrc Default file of automatically invoked commands 

SEE ALSO 

umask(l), wait(l). 

access(2), exec(2), fork(2), pipe(2), ssignal(3C), a.out(4), environ(5) in the 
Programmer's Reference Manual. 
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CREDIT 

This utility was developed at the University of California at Berkeley and is 
used with pern\ission. 

NOTES 

Words can be no longer than 512 characters. The number of arguments to a 
command which involves filename expansion is limited to 1/6 number of 
characters allowed in an argument list, which is 5120 less the characters in 
the environment. Also, command substitutions may substitute no more 
characters than are allowed in an argument list. 

To detect looping, the shell restricts the number of alias substitutions on a 
single line to 20. 

Built-in control structure commands like foreach and while cannot be used 
with the pipe symbol (I), ampersand (&), or semicolon (;). 

Commands within loops prompted for by ? are not placed in the history list. 

It is not possible to use the colon (:) modifiers on the output of command 
substitutions. 

Csh attempts to import and export the PATH variable for use with regular 
shell scripts. This only works for simple cases, where the PATH contains 
no command characters. 

This version of csh does not support or use the process control features of 
the 4th Berkeley Distribution. 

You can modify the list of commands that csh automatically invokes by 
editing the /etc/default/.cshrc file. For example, if you want to automati- 
cally assign the alias h to the history command, add the following line to 
the /etc/default/.cshrc file using the computer editor of your choice: 

alias history h 



- 20 - 



CSPLIT(l) 



(Editing Package) 



CSPLIT(l) 



NAME 

csplit - context split 
SYNOPSIS 

csplit [-S] [-k] [-f prefix ] file argl [. . . argn] 
DESCRIPTION 

The csplit command reads file and separates it into n+1 sections, defined by 
the arguments argl. . . argn. By default the sections are placed in xxOO . . . 
xxw {n may not be greater than 99). These sections get the following pieces 
of file: 

00: From the start of file up to (but not including) the line refer- 
enced by argl . 

01: From the line referenced by argl up to the line referenced by 
argl. 



n+1: From the line referenced by argn to the end of file. 

If the file argument is a then standard input is used. 
The options to csplit are: 

-s csplit normally prints the character counts for each file 

created. If the -s option is present, csplit suppresses the 
printing of all character counts. 

-k csplit normally removes created files if an error occurs. If 

the -k option is present, csplit leaves previously created 
files intact. 

-f prefix If the -f option is used, the created files are named prefixOO 
. . . prefixn. The default is xxOO . . . xxn. 

The arguments (argl . . . argn) to csplit can be a combination of the follow- 
ing: 

/rexp / A file is to be created for the section from the current line up 
to (but not including) the line containing the regular expres- 
sion rexp. The current line becomes the line containing 
rexp. This argument may be followed by an optional + or - 
some number of lines (e.g., /Page/-5). 

%rexp% 

This argument is the same as /rexp/ , except that no file is 
created for the section. 

Inno A file is to be created from the current line up to (but not 
including) Inno. The current line becomes Inno. 

{num\ Repeat argument. This argument may follow any of the 
above arguments. If it follows a rexp type argument, that 
argument is applied num more times. If it follows Inno, the 
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file will be split every Inno lines (num times) from that 
point. 

Enclose all rexp type arguments that contain blanks or other characters 
meaningful to the shell in the appropriate quotes. Regular expressions may 
not contain embedded new-lines, csplit does not affect the original file; it is 
the user's responsibility to remove it. 

EXAMPLES 

csplit -f cobol file '/procedure division/' /par5./ /pari 6./ 

This example creates four files, cobolOO . . . cobolOS. After editing the 
''split" files, they can be recombined as follows: 

cat cobol0[0-3] > file 

Note that this example overwrites the original file. 

csplit -k file 100 {99} 

This example would split the file at every 100 lines, up to 10,000 lines. The 
-k option causes the created files to be retained if there are less than 10,000 
lines; however, an error message would still be printed. 

csplit -k prog.c '%main(%' 'f}/+V {20} 

Assuming that prog.c follows the normal C coding convention of ending 
routines with a } at the beginning of the line, this example will create a file 
containing each separate C routine (up to 21) in prog.c. 

SEE ALSO 

ed(l), sh(l). 

regexp(5) in the Programmer's Reference Manual. 

DIAGNOSTICS 

Self-explanatory except for: 

arg - out of range 

which means that the given argument did not reference a line between the 
current position and the end of the file. 
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NAME 

ct - spawn getty to a remote terminal 
SYNOPSIS 

ct [ -wn ] [ -xn ] [ -h ] [ -V ] [ -sspeed ] telno ... 
DESCRIPTION 

The ct command dials the telephone number of a modem that is attached to 
a terminal, and spawns a getty process to that terminal. Telno is a tele- 
phone number, with equal signs for secondary dial tones and minus signs 
for delays at appropriate places. (The set of legal characters for telno is 
through 9, -, =, *, and #. The maximum length telno is 31 characters). If 
more than one telephone number is specified, the ct command will try each 
in succession until one answers; this is useful for specifying alternate dialing 
paths. 

ct will try each line listed in the file /usr/lib/uucp/Devices until it finds 
an available line with appropriate attributes or runs out of entries. If there 
are no free lines, ct will ask if it should wait for one, and if so, for how 
many minutes it should wait before it gives up. ct will continue to try to 
open the dialers at one-minute intervals until the specified limit is exceeded. 
The dialogue may be overridden by specifying the -wn option, where n is 
the maximum number of minutes that ct is to wait for a line. 

The -xn option is used for debugging; it produces a detailed output of the 
program execution on stderr. The debugging level, n, is a single digit; -x9 
is the most useful value. 

Normally, ct will hang up the current line, so the line can answer the 
incoming call. The -h option will prevent this action. The -h option will 
also wait for the termination of the specified ct process before returning 
control to the user's terminal. If the -v option is used, ct will send a run- 
ning narrative to the standard error output stream. 

The data rate may be set with the -s option, where speed is expressed in 
baud. The default rate is 1200. 

After the user on the destination terminal logs out, there are two things that 
could occur depending on what type of getty is on the line (getty or 
uugetty). For the first case, ct prompts. Reconnect? If the response begins 
with the letter n, the line will be dropped; otherwise, getty will be started 
again and the login: prompt will be printed. In the second case, there is 
already a getty (uugetty) on the line, so the login: message will appear. 

To log out properly, the user must type control D. 

Of course, the destination terminal must be attached to a modem that can 
answer the telephone. 

FILES 

/usr /lib / uucp /Devices 
/usr/adm/ctlog 

SEE ALSO 

cu(lC), getty(lM), login(l), uucp(lC), uugetty(lM). 
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For a shared port, one used for both dial-in and dial-out, the uugetty pro- 
gram running on the line must have the -r option specified [see 
uugetty{lM)], 
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NAME 

cu - call another UNIX system 
SYNOPSIS 

cu [-sspeed] [-Uine] [-h] [-t] [-d] [-o I -e] [-n] telno 
cu [ -s speed ] [ -h ] [ -d ] [ -o I -e ] -1 line 
cu [-h] [-d] [-0 I -e] systemname 

DESCRIPTION 

The cu command calls up another UNIX system, a terminal, or possibly a 
non-UNIX system. It manages an interactive conversation with possible 
transfers of ASCII files. 

The cu command accepts the following options and arguments: 

-sspeed Specifies the transmission speed (300, 1200, 2400, 4800, 9600); 

The default value is "Any" speed which will depend on the 
order of the lines in the /usr/lib/uucp/De vices file. Most 
modems are either 300 or 1200 baud. Directly connected lines 
may be set to a speed higher than 1200 baud. 

-lline Specifies a device name to use as the communication line. This 

can be used to override the search that would otherwise take 
place for the first available line having the right speed. When 
the -1 option is used without the -s option, the speed of a line 
is taken from the Devices file. When the -1 and -s options are 
both used together, cu will search the Devices file to check if 
the requested speed for the requested line is available. If so, 
the connection will be made at the requested speed; otherwise 
an error message will be printed and the call will not be made. 
The specified device is generally a directly connected asyn- 
chronous line (e.g., /dev/ityab) in which case a telephone 
number (telno) is not required. The specified device need not 
be in the /dev directory. If the specified device is associated 
with an auto dialer, a telephone number must be provided. 
Use of this option with systemname rather than telno will not 
give the desired result (see systemname below). 

-h Emulates local echo, supporting calls to other computer sys- 

tems which expect terminals to be set to half -duplex mode. 

-t Used to dial an ASCII terminal which has been set to auto 

answer. Appropriate mapping of carriage-return to carriage- 
return-line-feed pairs is set. 

-d Causes diagnostic traces to be printed. 

-o Designates that odd parity is to be generated for data sent to 

the remote system. 

-e Designates that even parity is to be generated for data sent to 

the remote system. 

-n For added security, will prompt the user to provide the tele- 

phone number to be dialed rather than taking it from the com- 
mand line. 
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telno When using an autonnatic dialer, the argument is the telephone 

nun\ber with equal signs for secondary dial tone or minus 
signs placed appropriately for delays of 4 seconds. 

systemname A uucp system name may be used rather than a telephone 
number; in this case, cu will obtain an appropriate direct line 
or telephone number from /usr/lib/uucp/Sy stems. Note: the 
systemname option should not be used in conjunction with the 
-1 and -s options as cu will connect to the first available line 
for the system name specified, ignoring the requested line and 
speed. 

After making the connection, cu runs as two processes: the transmit process 
reads data from the standard input and, except for lines beginning with 
passes it to the remote system; the receive process accepts data from the 
remote system and, except for lines beginning with passes it to the stan- 
dard output. Normally, an automatic DC3/DC1 protocol is used to control 
input from the remote system so the buffer is not overrun. Lines beginning 
with " have special meanings. 

The transmit process interprets the following user-initiated commands: 

terminate the conversation. 

*! escape to an interactive shell on the local system. 

"Icmd . . . run cmd on the local system (via sh -c). 

"icmd . . . run cmd locally and send its output to the remote sys- 

tem. 

change the directory on the local system. Note: led 
will cause the command to be run by a sub-shell, 
probably not what was intended. 

copy file from (on the remote system) to file to on the 
local system. If to is omitted, the from argument is 
used in both places. 

copy file from (on local system) to file to on remote 
system. If to is omitted, the from argument is used in 
both places. 

For both "Voinke and put commands, as each block of 
the file is transferred, consecutive single digits are 
printed to the terminal. 

send the line ~ line to the remote system. 

transmit a BREAK to the remote system (which can 
also be specified as "Vob). 

toggles the -d debugging option on or off (which can 
also be specified as "Vod). 

prints the values of the termio structure variables for 
the user's terminal (useful for debugging). 



"Vocd 

"o/otake from [ to ] 
"o/oput from [ to ] 



line 
"%break 

"VodebvLg 

"^t 
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prints the values of the termio structure variables for 
the remote communication line (useful for debugging). 

toggles between DC3/DC1 input control protocol and 
no input control. This is useful in case the remote 
system is one which does not respond properly to the 
DC3 and DCl characters. 

The receive process normally copies data from the remote system to its stan- 
dard output. Internally the program accomplishes this by initiating an out- 
put diversion to a file when a line from the remote begins with ~. 

Data from the remote is diverted (or appended, if » is used) to file on the 
local system. The trailing ~> marks the end of the diversion. 

The use of "Voput requires stty{l) and cat{l) on the remote side. It also 
requires that the current erase and kill characters on the remote system be 
identical to the current control characters on the local system. Backslashes 
are inserted at appropriate places. 

The use of "o/otake requires the existence of echo{l) and cat(l) on the remote 
system. Also, tabs mode [see stty(l)] should be set on the remote system if 
tabs are to be copied without expansion to spaces. 

When cu is used on system X to connect to system Y and subsequently used 
on system Y to connect to system Z, commands on system Y can be exe- 
cuted by using Executing a tilde command reminds the user of the local 
system uname. For example, uname can be executed on Z, X, and Y as fol- 
lows: 



uname 
Z 

~[X]!uname 
X 

""[YJIuname 
Y 

In general, * causes the command to be executed on the original machine, 
causes the command to be executed on the next machine in the chain. 

EXAMPLES 

To dial a system whose telephone number is 9 201 555 1212 using 1200 
baud (where dialtone is expected after the 9): 

cu -S1200 9=12015551212 

If the speed is not specified, " Any " is the default value. 
To log in to a system connected by a direct line, enter: 
cu -1 /dev/ttyXX 

or 

cu -1 ttyXX 



~%nostop 
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To dial a system with the specific line and a specific speed, enter: 
cu -S1200 -1 ttyXX 

To dial a system using a specific line associated with an auto dialer, enter: 
cu -1 culXX 9=12015551212 

To use a system name, enter: 
cu systemname 

FILES 

/usr /lib /uucp /Systems 
/usr /lib /uucp /Devices 
/usr /spool /locks /LCK. .(tty-device) 

SEE ALSO 

cat(l), ct(lC), echo(l), stty(l), uucp(lC), uname(l). 

DIAGNOSTICS 

Exit code is zero for normal exit, otherwise, one. 

WARNINGS 

The cu command does not do any integrity checking on data it transfers. 
Data fields with special cu characters may not be transmitted properly. 
Depending on the interconnection hardware, it may be necessary to use a 
to terminate the conversion even if stty has been used. Non-printing 
characters are not dependably transmitted using either the ""o/oput or ~%take 
commands, cu between some modems will not return a login prompt 
immediately upon connection. A carriage return will return the prompt. 

BUGS 

There is an artificial slowing of transmission by cu during the ~%put opera- 
tion so that loss of data is unlikely. 
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NAME 

custom - install specific portions of a XENIX package 

SYNOPSIS 

custom [-odt] [-irl [package]] [-f [file]] 

DESCRIPTION 

With custom you can create a custom installation by selectively installing or 
deleting portions of XENIX packages to or from the UNIX System V/386 
operating system, custom is executable only by the super-user. It can be 
used interactively or it can be invoked from the command line with applica- 
ble command options. 

Files are extracted or deleted in packages. A package is a collection of indi- 
vidual files. Packages are grouped together in sets. 

When in interactive mode, custom prompts you for volume 1 of the new 
product distribution and extracts the product information necessary to sup- 
port it. The following menu provides support for adding or removing a 
package: 

1. Install one or more packages 

2. Remove one or more packages 

3. List the files in a package 

4. Install a single file 

5. Select a new set to customize 

6. Display current disk usage 

7. Help 

The following describes what action occurs with the selection of a menu 
option: 

1. Install a package 

Prompts for one or more package names. 

Calculates which installation volumes (distribution media) are 
needed, then prompts for the correct volume numbers. If multiple 
packages are specified, the names should be separated by spaces on 
the command line. 

This option, as well as "2" and "3," displays a list of all available 
packages in the currently selected set. Each line describes the pack- 
age name; whether the package is fully installed, not installed, or 
partially installed; the size of the package (in 512 byte blocks); and 
a one-line description of the package contents. 

2. Remove a package 

Prompts for one or more package names. 

Deletes the correct files in the specified package. If multiple pack- 
ages are specified, the names should be separated by spaces on the 
command line. 

Displays available packages (see option "1"). 
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3. List files in a package 

Lists all files in the specified package. 

Prompts for one or more package names. Enter the name of the 
desired package(s). 

Displays available packages (see option "1"). 

4. Install a single file 

Extract the specified file from the distribution set. 

Filename should be a full pathname relative to the root directory 

5. Select a new set 

Allows you to work from a different set than the current one. 

6. Display current disk usage 

Tells you your current disk usage. 

7. Help 

Displays instructions to help you use custom. 

To use custom from the command line, you must include the necessary 
information using one of the following options: 

-s A set identifier 

-i Install the specified package(s) 

-r Remove the specified package(s) 

-1 List the files in the specified package(s) 

-f Install the specified file 

If any information is missing from the command line, custom prompts for 
the missing data. 

FILES 

/etc/perms/* 
SEE ALSO 

fixperm(lM), df(lM), du(IM), installpkg(l) 
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NOTES 

If you insert an invalid product or a volume out of order, you will be 
prompted to reinsert the correct volume. 

Packages containing device drivers cannot be installed using custom. 

custom has been provided for use v^ith any existing XENIX packages you 
may have that you wish to install on the UNIX operating system. To install 
UNIX System packages, use installpkgd). 
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NAME 

cut - cut out selected fields of each line of a file 

SYNOPSIS 

cut -clist [file ..,] 

cut -flist [-debar] [-s] [file ...] 

DESCRIPTION 

Use cut to cut out columns from a table or fields from eacb line of a file; in 
data base parlance, it implements the projection of a relation. The fields as 
specified by list can be fixed length, i.e., character positions as on a 
punched card (-c option), or the length can vary from line to line and be 
marked with a field delimiter character like tab (-f option), cut can be used 
as a filter; if no files are given, the standard input is used. In addition, a file 
name of explicitly refers to standard input. 

The meanings of the options are: 

list A comma-separated list of integer field numbers (in increasing 
order), with optional - to indicate ranges [e.g., 1,4,7; 1-3,8; -5,10 
(short for 1-5,10); or 3- (short for third through last field)]. 

-clist The list following -c (no space) specifies character positions (e.g., 
-cl-72 would pass the first 72 characters of each line). 

-Hist The list following -f is a list of fields assumed to be separated in 
the file by a delimiter character (see -d ); e.g., -fl,7 copies the first 
and seventh field only. Lines with no field delimiters will be 
passed through intact (useful for table subheadings), unless -s is 
specified. 

-dchar The character following -d is the field delimiter (-f option only). 

Default is tab. Space or other characters with special meaning to 
the shell must be quoted. 

-s Suppresses lines with no delimiter characters in case of -f option. 

Unless specified, lines with no delimiters will be passed through 
untouched. 

Either the -c or -f option must be specified. 

Use grep(l) to make horizontal "cuts" (by context) through a file, or paste(l) 
to put files together column-wise (i.e., horizontally). To reorder columns in 
a table, use cut and paste. 

EXAMPLES 

cut -d: -fl,5 /etc/passwd mapping of user IDs to names 

name='who am i I cut -fl -d" to set name to current login name. 

DIAGNOSTICS 

ERROR: line too long A line can have no more than 1023 characters or 
fields, or there is no new-line character. 

ERROR: bad list for c / f option 

Missing -c or -f option or incorrectly specified list. 
No error occurs if a line has fewer fields than the list 
calls for. 
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ERROR: no fields The list is empty. 

ERROR: no delimiter Missing char on -d option. 

ERROR: cannot handle multiple adjacent backspaces 

Adjacent backspaces cannot be processed correctly. 

WARNING: cannot open <filename> 

Either filename cannot be read or does not exist. If 
multiple file names are present, processing continues. 

SEE ALSO 

grep(l), paste(l). 
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NAME 

date - print and set the date 

SYNOPSIS 

date [+ format] 

date [ mmddhhmm[ [yy] I [ccyy]]] 
DESCRIPTION 

If no argument is given, or if the argument begins with +, the current date 
and time are printed. Otherwise, the current date is set (only by the super- 
user). The first mm is the month number; dd is the day number in the 
month; hh is the hour number (24-hour system); the second mm is the 
minute number; cc is the century minus one and is optional; yy is the last 2 
digits of the year number and is optional. For example: 

date 10080045 

sets the date to Oct 8, 12:45 AM. The current year is the default if no year 
is mentioned. The system operates in GMT. date takes care of the conver- 
sion to and from local standard and daylight saving time. Only the super- 
user may change the date. 

If the argument begins with +, the output of date is under the control of the 
user. All output fields are of fixed size (zero-padded if necessary). Each 
Field Descriptor is preceded by % and will be replaced in the output by its 
corresponding value. A single % is encoded by %%. All other characters 
are copied to the output without change. The string is always terminated 
with a new-line character. If the argument contains embedded blanks, it 
must be quoted (see the EXAMPLE section). 

Specifications of native language translations of month and weekday names 
are supported. The language used depends on the value of the environment 
variable LANGUAGE [see environ{5)]. The month and weekday names used 
for a language are taken from strings in the file for that language in the 
/lib/cftime directory [see cftime(4)]. 

After successfully setting the date and time, date will display the new date 
according to the format defined in the environment variable CFTIME [see 
environ (5)]. 



Field Descriptors (must be preceded by a %): 


a 


abbreviated weekday name 


A 


full weekday name 


b 


abbreviated month name 


B 


full month name 


d 


day of month - 01 to 31 


D 


date as mm/dd/yy 


e 


day of month - 1 to 31 (single digits are preceded by a blank) 


h 


abbreviated month name (alias for %b) 


H 


hour - 00 to 23 


I 


hour - 01 to 12 


j 


day of year - 001 to 366 
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m month of year - 01 to 12 

M minute - 00 to 59 

n insert a new-line character 

p string containing ante-meridiem or post-meridiem indicator (by 
default, AM or PM) 

r time as hh:mm:ss pp where pp is the ante-meridiem or post- 
meridiem indicator (by default, AM or PM) 

R time as hh:mm 

S second - 00 to 59 

t insert a tab character 

T time as hh:mm:ss 

U week number of year (Sunday as the first day of the week) - 

01 to 52 
w day of week - Sunday = 

W week number of year (Monday as the first day of the week) - 
01 to 52 

X Country-specific date format 
X Country-specific time format 
y year within century - 00 to 99 
Y year as ccyy (4 digits) 
Z timezone name 

EXAMPLE 

date '4-DATE: %m/%d/%y%nTIME: %H:%M:%S' 

would have generated as output: 

DATE: 08/01/76 
TIME: 14:45:05 

DIAGNOSTICS 

No permission if you are not the super-user and you try to change 

the date 

bad conversion if the date set is syntactically incorrect 

bad format character if the field descriptor is not recognizable. 

FILES 

/dev/kmem 

NOTE 

Administrators should note the following: if you attempt to set the current 
date to one of the dates that the standard and alternate time zones change 
(for example, the date that daylight time is starting or ending), and you 
attempt to set the time to a time in the interval between the end of standard 
time and the beginning of the alternate time (or the end of the alternate 
time and the beginning of standard time), the results are unpredictable. 

SEE ALSO 

cftime(4), environ(5). 
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NAME 

dc - desk calculator 

SYNOPSIS 

dc [ file ] 

DESCRIPTION 

The dc command is an arbitrary precision arithmetic package. Ordinarily, it 
operates on decimal integers, but one may specify an input base, output 
base, and a number of fractional digits to be maintained. [See hc(l), a 
preprocessor for dc that provides infix notation and a C-like syntax that 
implements functions, be also provides reasonable control structures for 
programs.] The overall structure of dc is a stacking (reverse Polish) calcula- 
tor. If an argument is given, input is taken from that file until its end, then 
from the standard input. The following constructions are recognized: 

number 

The value of the number is pushed on the stack. A number is an 
unbroken string of the digits 0-9, It may be preceded by an under- 
score (_) to input a negative number. Numbers may contain decimal 
points. 

/ * % ^ 

The top two values on the stack are added (-h), subtracted (-), multi- 
plied (*), divided (/), remaindered (%), or exponentiated ("). The two 
entries are popped off the stack; the result is pushed on the stack in 
their place. Any fractional part of an exponent is ignored. 

The top of the stack is popped and stored into a register named x, 
where x may be any character. If the s is capitalized, x is treated as a 
stack and the value is pushed on it. 

The value in register x is pushed on the stack. The register x is not 
altered. All registers start with zero value. If the 1 is capitalized, 
register x is treated as a stack and its top value is popped onto the 
main stack. 

The top value on the stack is duplicated. 

The top value on the stack is printed. The top value remains 
unchanged. 

Interprets the top of the stack as an ASCII string, removes it, and 
prints it. 

All values on the stack are printed. 

Exits the program. If executing a string, the recursion level is popped 
by two. 

Exits the program. The top value on the stack is popped and the 
string execution level is popped by that value. 

Treats the top element of the stack as a character string and executes 
it as a string of dc commands. 

Replaces the number on the top of the stack with its scale factor. 



+ - 

sx 
Ix 

d 
P 

P 
f 

q 
Q 

X 

X 
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[ ... ] Puts the bracketed ASCII string onto the top of the stack. 
<x >x =x 

The top two elements of the stack are popped and compared. Regis- 
ter X is evaluated if they obey the stated relation. 

V Replaces the top element on the stack by its square root. Any exist- 
ing fractional part of the argument is taken into account, but other- 
wise the scale factor is ignored. 

! Interprets the rest of the line as a UNIX system command. 

c All values on the stack are popped. 

i The top value on the stack is popped and used as the number radix 
for further input. 

I Pushes the input base on the top of the stack. 

o The top value on the stack is popped and used as the number radix 
for further output. 

O Pushes the output base on the top of the stack. 

k The top of the stack is popped, and that value is used as a non- 
negative scale factor: the appropriate number of places are printed 
on output, and maintained during multiplication, division, and 
exponentiation. The interaction of scale factor, input base, and out- 
put base will be reasonable if all are changed together. 

z The stack level is pushed onto the stack. 

Z Replaces the number on the top of the stack with its length. 

? A line of input is taken from the input source (usually the terminal) 
and executed. 

; : are used by hc{\) for array operations. 

EXAMPLE 

This example prints the first ten values of n!: 

[laH-dsa*plalO>y]sy 

Osal 

lyx 

SEE ALSO 

bc(l). 

DIAGNOSTICS 

X is unimplemented 

where x is an octal number. 

stack empty 

for not enough elements on the stack to do what was asked. 
Out of space 

when the free list is exhausted (too many digits). 

Out of headers 

for too many numbers being kept around. 
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Out of pushdown 

for too many items on the stack. 

Nesting Depth 

for too many levels of nested execution. 
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NAME 

dcopy - copy file systems for optimal access time 
SYNOPSIS 

/etc/dcopy [-sX] [-an] [-d] [-v] [-ffsize[:isize]] inputfs outputfs 
DESCRIPTION 

The dcopy command copies file system inputfs to outputfs. Inputfs is the 
device file for the existing file system; outputfs is the device file to hold the 
reorganized result. For the most effective optimization, inputfs should be 
the raw device and outputfs should be the block device. Both inputfs and 
outputfs should be unmounted file systems. 

With no options, dcopy copies files from inputfs compressing directories by 
removing vacant entries, and spacing consecutive blocks in a file by the 
optimal rotational gap. The possible options are: 

-sX supply device information for creating an optimal organization of 

blocks in a file. The forms of X are the same as the -s option of 
fsck(lU). 

-aw place the files not accessed in w days after the free blocks of the 

destination file system (default for w is 7). If no w is specified, 
then no movement occurs. 

-d leave order of directory entries as is (default is to move sub- 

directories to the beginning of directories). 

-V currently reports how many files were processed, and how big 

the source and destination freelists are. 

-ifsize[:isize] 

specify the outputfs file system and inode list sizes (in blocks). If 
the option (or lisize) is not given, the values from the inputfs are 
used. 

dcopy catches interrupts and quits, and reports on its progress. To terminate 
dcopy send a quit signal, followed by an interrupt or quit. 

SEE ALSO 

fsck(lM), mkfs(lM), ps(l). 
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NAME 

dd - convert and copy a file 

SYNOPSIS 

dd [option= value] ... 

DESCRIPTION 

The dd command copies the specified input file to the specified output with 
possible conversions. The standard input and output are used by default. 
The input and output block size may be specified to take advantage of raw 
physical I/O. 

option values 

if=file input file name; standard input is default 

of=file output file name; standard output is default 

ibs=n input block size n bytes (default 512) 

obs=n output block size (default 512) 

bs=n set both input and output block size, superseding ibs and 

obs; also, if no conversion is specified, it is particularly effi- 
cient since no in-core copy need be done 
cbs=n conversion buffer size 

skip=w skip n input blocks before starting copy 

seek=n seek n blocks from beginning of output file before copying 

count =M copy only n input blocks 
conv=ascii convert EBCDIC to ASCII 

ebcdic convert ASCII to EBCDIC 

ibm slightly different map of ASCII to EBCDIC 

lease map alphabetics to lower case 

ucase map alphabetics to upper case 

swab swap every pair of bytes 

noerror 

do not stop processing on an error 
sync pad every input block to ibs 
....... several comma-separated conversions 

Where sizes are specified, a number of bytes is expected. A number may 
end with k, b, or w to specify multiplication by 1024, 512, or 2, respec- 
tively; a pair of numbers may be separated by x to indicate multiplication. 

The cbs is used only if conv=ascii or conv=ebcdic is specified. In the 
former case, cbs characters are placed into the conversion buffer (converted 
to ASCII). Trailing blanks are trimmed and a new-line added before sending 
the line to the output. In the latter case, ASCII characters are read into the 
conversion buffer (converted to EBCDIC). Blanks are added to make up an 
output block of size cbs. 

After completion, dd reports the number of whole and partial input and out- 
put blocks. 

DIAGNOSTICS 

f+p blocks in(out) numbers of full and partial blocks read(written) 
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NAME 

deluser - remove a login from the system 

SYNOPSIS 

deluser loginid Yes/No logdir 

DESCRIPTION 

deluser is used to remove a user id from the system. Once the id has been 
removed, the user will no longer have access to the system. 

loginid This is the login that is being removed from the system. 

Yes I No This argument determines whether or not the user's files should 
be saved when the login is removed. 

If Yes is specified, all files in the user's home directory will be 
copied to /lost+found/<loginid> before the home directory is 
removed. 

If No is specified, the files in $HOME will not be removed. 
logdir This is the user's home directory. 
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NAME 

deroff - remove nroff/troff, tbl, and eqn constructs 

SYNOPSIS 

deroff [-mx] [-w] [ files ] 

DESCRIPTION 

The deroff command reads each of the files in sequence and removes all 
troff(\) requests, macro calls, backslash constructs, eqn(\) constructs 
(between .EQ and .EN lines and between delimiters), and ^^7/(1) descriptions, 
perhaps replacing them with white space (blanks and blank lines), and 
writes the remainder of the file on the standard output. 

Note: troffiVj, nroff{\), and eqn{\) are not part of this UNIX system release. 
deroff follows chains of included files (.so and .nx troff commands); if a file 
has already been included, a .so naming that file is ignored and a .nx nam- 
ing that file terminates execution. If no input file is given, deroff reads the 
standard input. 

The -m option may be followed by an m, s, or I. The -mm option causes 
the macros to be interpreted so that only running text is output (i.e., no text 
from macro lines). The -ml option forces the -mm option and also causes 
deletion of lists associated with the mm macros. 

If the -w option is given, the output is a word list, one "word" per line, 
with all other characters deleted. Otherwise, the output follows the original 
with the deletions mentioned above. In text, a "word" is any string that 
contains at least two letters and is composed of letters, digits, ampersands 
(&), and apostrophes ('); in a macro call, however, a "word" is a string that 
begins with at least two letters and contains a total of at least three letters. 
Delimiters are any characters other than letters, digits, apostrophes, and 
ampersands. Trailing apostrophes and ampersands are removed from 
"words." 

BUGS 

deroff is not a complete troff interpreter, so it can be confused by subtle con- 
structs. Most such errors result in too much rather than too little output. 
The -ml option does not handle nested lists correctly. 
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NAME 

devnm - device name 

SYNOPSIS 

/etc/devnm [names] 

DESCRIPTION 

The devnm command identifies the special file associated with the mounted 
file system where the argument name resides. 

This command is most commonly used by /etc/brc [see brc (IM)] to con- 
struct a mount table entry for the root device. 

EXAMPLE 

The command: 

/etc/devnm /usr 
produces 

/dev/dsk/0s3 
if /usr is mounted on /dev/dsk/0s3. 

FILES 

/dev/dsk/* 
/etc/mnttab 

SEE ALSO 

brc(lM). 
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NAME 

df - report number of free disk blocks and inodes 
SYNOPSIS 

df [-It] [-f] \file-system I directory I mounted-resource] 
DESCRIPTION 

The df command prints out the number of free blocks and free inodes in 
mounted file systems, directories, or mounted resources by examining the 
counts kept in the super-blocks. 

The file-system may be specified either by device name (e.g., /dev/dsk/Osl) 
or by mount point directory name (e.g., /usr). 

directory can be a directory name. The report presents information for the 
device that contains the directory. 

mounted-resource can be a remote resource name. The report presents infor- 
mation for the remote device that contains the resource. 
If no arguments are used, the free space on all locally and remotely 
mounted file systems is printed. 
The df command uses the following options: 
-1 only reports on local file systems. 

-t causes the figures for total allocated blocks and inodes to be 

reported as well as the free blocks and inodes. 
-f an actual count of the blocks in the free list is made, rather than 

taking the figure from the super-block (free inodes are not reported). 

This option will not print any information about mounted remote 

resources. 

-V reports percent of blocks used as well as the number of blocks used 
and free. 

NOTE 

If multiple remote resources are listed that reside on the same file system on 
a remote machine, each listing after the first one will be marked with an 
asterisk. 

FILES 

/dev/dsk/* 
/etc/mnttab 

SEE ALSO 

mount(lM). 

fs(4), mnttab(4) in the Programmer's Reference Manual 
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NAME 

diff - differential file comparator 

SYNOPSIS 

diff [ -efbh ] filel file2 

DESCRIPTION 

The diff command tells what lines must be changed in two files to bring 
them into agreement. If filel (file!) is - the standard input is used. If filel 
(file!) is a directory, then a file in that directory with the name file2 {filel) is 
used. The normal output contains lines of these forms: 

nl a n3,n4 
nl,n2 d n3 
nl,n2 c n3,n4 

These lines resemble ed commands to convert filel into filel. The numbers 
after the letters pertain to filel. In fact, by exchanging a for d and reading 
backward one may ascertain equally how to convert filel into filel . As in 
ed, identical pairs (where nl = nl or n3 = n4) are abbreviated as a single 
number. 

Following each of these lines come all the lines that are affected in the first 
file flagged by <, then all the lines that are affected in the second file 
flagged by >. 

The -b option causes trailing blanks (spaces and tabs) to be ignored and 
other strings of blanks to compare equal. 

The -e option produces a script of a, c, and d commands for the editor ed, 
which will recreate filel from filel . The -f option produces a similar script, 
not useful with ed, in the opposite order. In connection with -e, the follow- 
ing shell program may help maintain multiple versions of a file. Only an 
ancestral file ($1) and a chain of version-to-version ed scripts ($2,$3,...) 
made by diff need be on hand. A "latest version" appears on the standard 
output. 

(shift; cat $*; echo 'l,$p') | ed - $1 

Except in rare circumstances, diff finds a smallest sufficient set of file differ- 
ences. 

Option -h does a fast, half-hearted job. It works only when changed 
stretches are short and well separated, but does work on files of unlimited 
length. Options -e and -f are unavailable with -h. 

FILES 

/tmp/d????? 
/usr/lib/diffh for -h 

SEE ALSO 

bdiff(l), cmp(l), comm(l), ed(l). 

DIAGNOSTICS 

Exit status is for no differences, 1 for some differences, 2 for trouble. 
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BUGS 

Editing scripts produced under the -e or -f option are naive about creating 
lines consisting of a single period (.). 

WARNINGS 

Missing newline at end affile X 

indicates that the last line of file X did not have a new-line. If the lines are 
different, they will be flagged and output although the output will seem to 
indicate they are the same. 
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NAME 

diff3 - 3-way differential file comparison 

SYNOPSIS 

diff3 [ -ex3 ] filel file2 file3 

DESCRIPTION 

The diffS command compares three versions of a file, and publishes 
disagreeing ranges of text flagged with these codes: 

===== all three files differ 

====1 filel is different 

====2 filel is different 

====3 file 3 is different 

The type of change suffered in converting a given range of a given file to 
some other is indicated in one of these ways: 

f : nl a. Text is to be appended after line number nl in file 

/, where / = 1, 2, or 3. 

f : nl , nl c Text is to be changed in the range line nl to line 
nl. If nl = nl, the range may be abbreviated to 
nl. 

The original contents of the range follows immediately after a c indication. 
When the contents of two files are identical, the contents of the lower- 
numbered file is suppressed. 

Under the -e option, diffS publishes a script for the editor ed that will incor- 
porate into filel all changes between filel and fileS, i.e., the changes that 
normally would be flagged ==== and =====3. Option -x (-3) produces a 
script to incorporate only changes flagged ==== (====3). The following 
command will apply the resulting script to filel . 

(cat script; echo 'l,$p') | ed - filel 

FILES 

/tmp/d3* 
/usr/lib /diff3prog 

SEE ALSO 

diff(l). 

BUGS 

Text lines that consist of a single . will defeat -e. 
Files longer than 64K bytes will not work. 
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NAME 

dircmp - directory comparison 
SYNOPSIS 

dircmp [ -d ] [ -s ] [ -w n ] dirl dir2 
DESCRIPTION 

The dircmp command examines dirl and dirl and generates various tabu- 
lated information about the contents of the directories. Listings of files that 
are unique to each directory are generated for all the options. If no option 
is entered, a list is output indicating whether the file names common to 
both directories have the same contents. 



-d 



-s 




Change the width of the output line to n characters. The default 
width is 72. 



SEE ALSO 



cmp(l). 



diff(l). 
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NAME 

diskadd - disk partitioning utility 

SYNOPSIS 

/etc/diskadd [disk_number] 

DESCRIPTION 

This shell script (in conjunction with the program /etc/adddisk) allows the 
system administrator to set up additional disks for use by the UNIX system. 
(The initial system disk is configured during system installation.) It is an 
interactive program which prompts the user for information about the setup 
of the disk and allows specification of known media defects. It allows the 
partitioning of the disk into a imp file system (if desired), additional 
swap/paging space (if desired), and from 1 to 4 user file systems. All input 
is double-checked with the user for correctness. The user is then asked 
whether the file systems on the new disk should be mounted automatically. 
Finally, the disk is verified and file systems are created. If automatic 
mounting was specified, directories are created in the root file system to 
hold the new file systems, they are mounted, and /etc/fstab is updated to 
remount them on subsequent bootups of the system. Device and partition 
stanzas for the new disk are appended to the /etc/partitions file for use 
with mkpart{lM). 

Prior to running diskadd, the system administrator must create special files 
in /dev/dsk and /dev/rdsk for accessing the new disk. The names of 
these files are of the form /dev/[r]dsk/[cfd]/s/:, where / is the controller 
number (cfd is omitted for controller 0), ; is the drive number on the con- 
troller, and k is the partition number on the disk. The minimum set of spe- 
cial files for a new disk is a character (rdsk) device for partition 
(/dev/rdsk/lsO for the second drive on the first controller), and block (dsk) 
device for each partition added. Partition 1 is always tmp (if specified), par- 
tition 2 is always swap (if specified), and new user file systems are made in 
partitions 3-6. 

The fdisk program will be run by diskadd to create a DOS-style partition 
table. The user is expected to use fdisk to create a UNIX partition. By 
default, diskadd will set up /dev/rdsk/lsO (the second disk on Con- 
troller 0). A different disk can be used by giving one of the following argu- 
ments to diskadd: 

/dev/rdsk/lsO (default) 

/dev/rdsk/cldOsO 

/dev/rdsk/cldlsO 

During the execution of the mkpart command, warnings about having no 
root partition from which to boot will be issued. These may be ignored, as 
added disks are not bootable. 

If swap space is added on the new drive, it must be made available for sys- 
tem use with the swap{lM) program, diskadd doesn't do this, as there is no 
automatic facility for adding swap space on bootup. 
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FILES 

/tmp/partitions 

/tmp/addparts 

/tmp/mkfs.data 

/tmp/diskname 

/etc/partitions 

/dev/rdsk/*sO 

/dev/dsk/*s? 

/etc/fstab 

SEE ALSO 

mkfs(lM), mknod(l), mkpart(lM), swap(lM). 
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NAME 

diskusg - generate disk accounting data by user ID 

SYNOPSIS 

diskusg [options] [files] 

DESCRIPTION 

diskusg generates intermediate disk accounting information from data in 
files, or the standard input if omitted, diskusg outputs lines on the standard 
output, one per user, in the following format: uid login #blocks 

where 

uid the numerical user ID of the user. 

login the login name of the user; and 

#&/oc/iS the total number of disk blocks allocated to this user. 

diskusg normally reads only the inodes of file systems for disk accounting. 
In this case, files are the special filenames of these devices. 

diskusg recognizes the following options: 

-s the input data is already in diskusg output format, diskusg 

combines all lines for a single user into a single line. 

-V verbose. Print a list on standard error of all files that are 

charged to no one. 

-i fnmlist ignore the data on those file systems whose file system name 
is in fnmlist. Fnmlist is a list of file system names separated by 
commas or enclosed within quotes, diskusg compares each 
name in this list with the file system name stored in the 
volume ID [see lahelit{lM)]. 

-p file use file as the name of the password file to generate login 

names, /etc/passwd is used by default. 

-u file write records to file of files that are charged to no one. 

Records consist of the special file name, the inode number, and 
the user ID. 

The output of diskusg is normally the input to acctdisk [see acct (IM)] which 
generates total accounting records that can be merged with other accounting 
records, diskusg is normally run in dodisk [see acctsh{lM)], 

EXAMPLES 

The following will generate daily disk accounting information: 

for i in /dev/dsk/Osl /dev/dsk/0s3; do 
diskusg $i > dtmp.'basename $i' & 

done 
wait 

diskusg -s dtmp.* I sort +0n -fl I acctdisk > disktacct 

FILES 

/etc/passwd used for user ID to login name conversions 
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SEE ALSO 

acct(lM), acctsh(llV[) 

acct(4) in the Programmer's Reference Manual 
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NAME 

displaypkg - display installed packages 

SYNOPSIS 

displaypkg 

DESCRIPTION 

The displaypkg command will list the names of all the packages that were 
installed using the installpkg command. 

SEE ALSO 

installpkg(l), removepkg(l). 
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NAME 

dname - Print Remote File Sharing domain and network names 
SYNOPSIS 

dname [-D domain] [-N netspec] [-dna] 
DESCRIPTION 

The dname command prints or defines a host's Remote File Sharing domain 
name or the network used by Remote File Sharing as transport provider. 
When used with d, n, or a options, dname can be run by any user to print 
the domain name, network name, or both, respectively. Only a user with 
root permission can use the -D domain option to set the domain name for 
the host or -N netspec to set the network specification used for Remote File 
Sharing. (The value of netspec is the network device name, relative to the 
/dev directory. For example, the STARLAN NETWORK uses starlan.) 

The domain must consist of no more than 14 characters, consisting of any 
combination of letters (upper and lower case), digits, hyphens (-), and 
underscores (_) 

When dname is used to change a domain name, the host's password is 
removed. The administrator will be prompted for a new password the next 
time Remote File Sharing is started [rfstart(lM)]. 

If dname is used with no options, it will default to dname -d. 

ERRORS 

You cannot use the -N or -D options while Remote File Sharing is running. 

SEE ALSO 

rfstart(lM). 



- 1 - 



DU(IM) 



(Base System) 



DU(IM) 



NAME 

du - summarize disk usage 

SYNOPSIS 

du [ -sar ] [ names ] 

DESCRIPTION 

The du command reports the number of blocks contained in all files and 
(recursively) directories within each directory and file specified by the names 
argument. The block count includes the indirect blocks of the file. If names 
is missing, the current directory is used. 

The optional arguments are as follows: 

-s causes only the grand total (for each of the specified names) to be 
given. 

-a causes an output line to be generated for each file. 

If neither -s or -a is specified, an output line is generated for each directory 
only. 

-r will cause du to generate messages about directories that cannot be 
read, files that cannot be opened, etc., rather than being silent (the 
default). 

A file with two or more links is only counted once. 

BUGS 

If the -a option is not used, non-directories given as arguments are not 
listed. 

If there are links between files in different directories where the directories 
are on separate branches of the file system hierarchy, du will count the 
excess files more than once. 

Files with holes in them will get an incorrect block count. (See Chapter 6, 
All About File Systems, in the Operations /System Administration Guide.) 
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NAME 

echo - echo arguments 

SYNOPSIS 

echo [-n] [ arg ] ... 

DESCRIPTION 

The echo command writes its arguments separated by blanks and terminated 
by a new-line on the standard output. The -n option prints a line without 
the new-line; same as using the \c escape sequence. 

echo also understands C-like escape conventions; beware of conflicts with 
the shell's use of \: 

\b backspace 

\c print line without new-line 

\f form-feed 

\n new-line 

\r carriage return 

\t tab 

\v vertical tab 

\\ backslash 

\0w where n is the 8-bit character whose ASCII code is the 1-, 2- 
or 3-digit octal number representing that character. 

The echo command is useful for producing diagnostics in command files and 
for sending known data into a pipe. 

SEE ALSO 

sh(l). 

CAVEATS 

When representing an 8-bit character by using the escape convention \0n, 
the n must always be preceded by the digit zero (0). 

For example, typing: echo 'WARNING:\07' will print the phrase WARNING: 
and sound the ''bell" on your terminal. The use of single (or double) quotes 
(or two backslashes) is required to protect the "\" that precedes the "07". 

For the octal equivalents of each character, see ascii{5) in the Programmer's 
Reference Manual. 
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NAME 

ed, red - text editor 

SYNOPSIS 

ed [-S] [-p string ] [-x] [-C] [file] 

red [-S] [-P string ] [-x] [-C] [file] 

DESCRIPTION 

ed is the standard text editor. If the file argument is given, ed simulates an 
e command (see the following text) on the named file; that is to say, the file 
is read into ed's buffer so that it can be edited. 

-s Suppresses the printing of character counts by e, r, and w com- 
mands, of diagnostics from e and q commands, and of the ! prompt 
after a \shell command. 

-p Allows the user to specify a prompt string. 

-X Encryption option; when used, ed simulates an X command and 
prompts the user for a key. This key is used to encrypt and decrypt 
text using the algorithm of crypt (1). The X command makes an 
educated guess to determine whether text read in is encrypted or 
not. The temporary buffer file is encrypted also, using a 
transformed version of the key typed in for the -x option. See 
crypt (1). Also, see the WARNINGS section at the end of this manual 
page. 

-C Encryption option; the same as the -x option, except that ed simu- 
lates a C command. The C command is like the X command, 
except that all text read in is assumed to have been encrypted. 

ed operates on a copy of the file it is editing; changes made to the copy 
have no effect on the file until a w (write) command is given. The copy of 
the text being edited resides in a temporary file called the buffer. There is 
only one buffer. 

red is a restricted version of ed. It will allow editing of files only in the 
current directory. It prohibits executing shell commands via Ishell command. 
Attempts to bypass these restrictions result in an error message {restricted 
shell). 

Both ed and red support the fspec{4) formatting capability. After including a 
format specification as the first line of file and invoking ed with your termi- 
nal in stty -tabs or stty tab3 mode [see stty(l)], the specified tab stops will 
automatically be used when scanning file. For example, if the first line of a 
file contained: 

<:t5,10,15 s72:> 

tab stops would be set at columns 5, 10, and 15, and a maximum line 
length of 72 would be imposed. NOTE: When you are entering text into the 
file, this format is not in effect; instead, because of being in stty -tabs or 
stty tabs mode, tabs are expanded to every eighth column. 

Commands to ed have a simple and regular structure: zero, one, or two 
addresses followed by a single-character command, possibly followed by 
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parameters to that command. These addresses specify one or more lines in 
the buffer. Every command that requires addresses has default addresses, 
so that the addresses can very often be omitted. 

In general, only one command may appear on a line. Certain commands 
allow the input of text. This text is placed in the appropriate place in the 
buffer. While ed is accepting text, it is said to be in input mode. In this 
mode, no commands are recognized; all input is merely collected. Leave 
input mode by typing a period (.) at the beginning of a line, followed 
immediately by a carriage return. 

ed supports a limited form of regular expression notation; regular expressions 
are used in addresses to specify lines and in some commands (e.g., s) to 
specify portions of a line that are to be substituted. A regular expression 
(RE) specifies a set of character strings. A member of this set of strings is 
said to be matched by the RE. The REs allowed by ed are constructed as fol- 
lows: 

The following one-character REs match a single character: 

1.1 An ordinary character (not one of those discussed in 1.2 below) is a 
one-character RE that matches itself. 

1.2 A backslash (\) followed by any special character is a one-character 
RE that matches the special character itself. The special characters are: 

a. ., */ [/ and \ (period, asterisk, left square bracket, and backslash, 
respectively), which are always special, except when they appear 
within square brackets ([]; see 1.4 below). 

b. " (caret or circumflex), which is special at the beginning of an 
entire RE (see 3.1 and 3.2 below) or when it immediately follows 
the left of a pair of square brackets ([]) (see 1.4 below). 

c. $ (dollar sign), which is special at the end of an entire RE (see 3.2 
below). 

d. The character used to bound (i.e., delimit) an entire RE, which is 
special for that RE [for example, see how slash (/) is used in the 
g command, below.] 

1.3 A period (.) is a one-character RE that matches any character except 
new-line. 

1.4 A non-empty string of characters enclosed in square brackets ([]) is a 
one-character RE that matches any one character in that^ string. If, 
however, the first character of the string is a circumflex ("), the one- 
character RE matches any character except new-line and the remaining 
characters in the string. The " has this special meaning only if it 
occurs first in the string. The minus (-) may be used to indicate a 
range of consecutive ASCII characters; for example, [0-9] is equivalent 
to [0123456789]. The - loses this special meaning if it occurs first 
(after an initial if any) or last in the string. The right square 
bracket (]) does not terminate such a string when it is the first charac- 
ter within it (after an initial if any); e.g., []a-f] matches either a 
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right square bracket (]) or one of the letters a through f inclusive. 
The four characters listed in 1.2.a above stand for themselves within 
such a string of characters. 

The following rules may be used to construct REs from one-character REs: 

2.1 A one-character RE is a RE that matches whatever the one-character RE 
matches. 

2.2 A one-character RE followed by an asterisk (*) is a RE that matches 
zero or more occurrences of the one-character RE. If there is any 
choice, the longest leftmost string that permits a match is chosen. 

2.3 A one-character RE followed by \{m\}, \{m,\}/ or \{m,n\} is a RE 
that matches a range of occurrences of the one-character RE. The 
values of m and n must be non-negative integers less than 256; 
\{m\} matches exactly m occurrences; \{m,\} matches at least m 
occurrences; \{m,n\} matches any number of occurrences between m 
and n inclusive. Whenever a choice exists, the RE matches as many 
occurrences as possible. 

2.4 The concatenation of REs is a RE that matches the concatenation of the 
strings matched by each component of the RE. 

2.5 A RE enclosed between the character sequences \( and \) is a RE that 
matches whatever the unadorned RE matches. 

2.6 The expression \n, matches the same string of characters as was 
matched by an expression enclosed between \( and \) earlier in the 
same RE. Here « is a digit; the sub-expression specified is that begin- 
ning with the «-th occurrence of \( counting from the left. For exam- 
ple, the expression "\(.*\)\1$ matches a line consisting of two 
repeated appearances of the same string. 

Finally, an entire RE may be constrained to match only an initial segment or 
final segment of a line (or both). 

3.1 A circumflex (") at the beginning of an entire RE constrains that RE to 
match an initial segment of a line. 

3.2 A dollar sign ($) at the end of an entire RE constrains that RE to match 
a final segment of a line. 

The construction ^entire RE$ constrains the entire RE to match the entire 
line. 

The null RE (e.g., //) is equivalent to the last RE encountered. See also the 
last paragraph before FILES below. 

To understand addressing in ed, it is necessary to know that at any time 
there is a current line. Generally speaking, the current line is the last line 
affected by a command; the exact effect on the current line is discussed 
under the description of each command. Addresses are constructed as fol- 
lows: 

1. The character . addresses the current line. 
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2. The character $ addresses the last line of the buffer. 

3. A decimal number n addresses the n-th line of the buffer. 

4. 'x addresses the line marked with the mark name character x, which 
must be an ASCII lower-case letter (a-z). Lines are marked with the k 
command described below. 

5. A RE enclosed by slashes (/) addresses the first line found by search- 
ing forward from the line following the current line toward the end of 
the buffer and stopping at the first line containing a string matching 
the RE. If necessary, the search wraps around to the beginning of the 
buffer and continues up to and including the current line, so that the 
entire buffer is searched. See also the last paragraph before FILES. 

6. A RE enclosed in question marks (?) addresses the first line found by 
searching backward from the line preceding the current line toward the 
beginning of the buffer and stopping at the first line containing a 
string matching the RE. If necessary, the search wraps around to the 
end of the buffer and continues up to and including the current line. 
See also the last paragraph before FILES. 

7. An address followed by a plus sign ( + ) or a minus sign (-) followed 
by a decimal number specifies that address plus (respectively minus) 
the indicated number of lines. The plus sign may be omitted. 

8. If an address begins with + or the addition or subtraction is taken 
with respect to the current line; e.g, -5 is understood to mean .-5. 

9. If an address ends with -h or -, then 1 is added to or subtracted from 
the address, respectively. As a consequence of this rule and of Rule 8, 
immediately above, the address - refers to the line preceding the 
current line. (To maintain compatibility with earlier versions of the 
editor, the character ^ in addresses is entirely equivalent to -.) More- 
over, trailing -h and - characters have a cumulative effect, so — refers 
to the current line less 2. 

10. For convenience, a comma {,) stands for the address pair 1,$, while a 
semicolon (;) stands for the pair .,$. 

Commands may require zero, one, or two addresses. Commands that 
require no addresses regard the presence of an address as an error. Com- 
mands that accept one or two addresses assume default addresses when an 
insufficient number of addresses is given; if more addresses are given than 
such a command requires, the last one(s) are used. 

Typically, addresses are separated from each other by a comma (,). They 
may also be separated by a semicolon (;). In the latter case, the current line 
(.) is set to the first address, and only then is the second address calculated. 
This feature can be used to determine the starting line for forward and 
backward searches (see Rules 5 and 6 above). The second address of any 
two-address sequence must correspond to a line that follows, in the buffer, 
the line corresponding to the first address. 

In the following list of ed commands, the default addresses are shown in 
parentheses. The parentheses are not part of the address; they show that 
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the given addresses are the default. 

It is generally illegal for more than one command to appear on a line. 
However, any command (except e, f, r, ox w) may be suffixed by 1, n, or p 
in which case the current line is either listed, numbered, or printed, respec- 
tively, as discussed below under the / , w, and p commands. 

(.)a 

<text> 

The Append command reads the given text and appends it after the 
addressed line; . is left at the last inserted line, or, if there were 
none, at the addressed line. Address is legal for this command: it 
causes the ''appended" text to be placed at the beginning of the 
buffer. The maximum number of characters that may be entered 
from a terminal is 256 per Une (including the new-line character). 

(.)c 

<text> 

The change command deletes the addressed lines, then accepts 
input text that replaces these lines; . is left at the last line input, or, 
if there were none, at the first line that was not deleted. 

C 

Same as the X command, except that ed assumes all text read in for 
the e and r commands is encrypted unless a null key is typed in. 

(.,.)d 

The delete command deletes the addressed lines from the buffer. 
The line after the last line deleted becomes the current line; if the 
lines deleted were originally at the end of the buffer, the new last 
line becomes the current line. 

e file 

The edit command causes the entire contents of the buffer to be 
deleted, and then the named file to be read in; . is set to the last 
line of the buffer. If no file name is given, the currently remem- 
bered file name, if any, is used (see the / command). The number 
of characters read is typed; file is remembered for possible use as a 
default file name in subsequent e, r, and w commands. If file is 
replaced by !, the rest of the line is taken to be a shell [s/i(l)] com- 
mand whose output is to be read. Such a shell command is not 
remembered as the current file name. See also DIAGNOSTICS. 

E file 

The Edit command is like e, except that the editor does not check to 
see if any changes have been made to the buffer since the last w 
command. 

ifile 

If file is given, the /ile-name command changes the currently 
remembered file name to file; otherwise, it prints the currently 
remembered file name. 



-5 - 



ED(1) 



(Base System) 



ED(1) 



(1,%)%/ RE /command list 

In the global command, the first step is to mark every line that 
matches the given RE. Then, for every such line, the given command 
list is executed with . initially set to that line. A single command or 
the first of a list of commands appears on the same line as the glo- 
bal command. All lines of a multi-line list except the last line must 
be ended with a \; a, i, and c commands and associated input are 
permitted. The . terminating input mode may be omitted if it would 
be the last line of the command list. An empty command list is 
equivalent to the p command. The g, G, v, and V commands are 
not permitted in the command list. See also BUGS and the last para- 
graph before FILES. 

(1,$)G/RE/ 

In the interactive Global command, the first step is to mark every 
line that matches the given RE. Then, for every such line, that line 
is printed, . is changed to that line, and any one command (other 
than one of the a, c, i, g, G, v, and V commands) may be input and 
is executed. After the execution of that command, the next marked 
line is printed, and so on; a new-line acts as a null command; an & 
causes the re-execution of the most recent command executed 
within the current invocation of G. Note that the commands input 
as part of the execution of the G command may address and affect 
any lines in the buffer. The G command can be terminated by an 
interrupt signal (ASCII DEL or BREAK). 

h 

The ^elp command gives a short error message that explains the 
reason for the most recent ? diagnostic. 

H 

The Help command causes ed to enter a mode in which error mes- 
sages are printed for all subsequent ? diagnostics. It will also 
explain the previous ? if there was one. The H command alter- 
nately turns this mode on and off; it is initially off. 

(.)i 

<text> 

The fnsert command inserts the given text before the addressed line; 
. is left at the last inserted line, or, if there were none, at the 
addressed line. This command differs from the a command only in 
the placement of the input text. Address is not legal for this com- 
mand. The maximum number of characters that may be entered 
from a terminal is 256 per line (including the new-line character). 

(.,.+l)j 

The ;oin command joins contiguous lines by removing the appropri- 
ate new-line characters. If exactly one address is given, this com- 
mand does nothing. 

(.)kjc 

The mar A: command marks the addressed line with name x, which 
must be an ASCII lower-case letter (a-z). The address 'x then 
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addresses this line; . is unchanged. 

(.,.)! 

The /ist command prints the addressed lines in an unambiguous 
way: a few non-printing characters (e.g., tab, backspace) are 
represented by visually mnemonic overstrikes. All other non- 
printing characters are printed in octal, and long lines are folded. 
An / command may be appended to any command other than e, /, 
r, or 

(.,.)ma 

The move command repositions the addressed line(s) after the line 
addressed by a. Address is legal for a and causes the addressed 
line(s) to be moved to the beginning of the file. It is an error if 
address a falls within the range of moved lines; . is left at the last 
line moved. 

(.,.)n 

The w umber command prints the addressed lines, preceding each 
line by its line number and a tab character; . is left at the last line 
printed. The n command may be appended to any command other 
than e, /, r, or u?. 

(.,.)p 

The print command prints the addressed lines; . is left at the last 
line printed. The p command may be appended to any command 
other than e, /, r, or For example, dp deletes the current line 
and prints the new current line. 

P 

The editor will prompt with a * for all subsequent commands. The 
P command alternately turns this mode on and off; it is initially off. 

q 

The quit command causes ed to exit. No automatic write of a file is 
done; however, see DIAGNOSTICS. 

Q 

The editor exits without checking if changes have been made in the 
buffer since the last w command. 

($)rfile 

The read command reads in the given file after the addressed line. 
If no file name is given, the currently remembered file name, if any, 
is used (see e and / commands). The currently remembered file 
name is not changed unless file is the very first file name mentioned 
since ed was invoked. Address is legal for r and causes the file to 
be read at the beginning of the buffer. If the read is successful, the 
number of characters read is typed; . is set to the last line read in. If 
file is replaced by !, the rest of the line is taken to be a shell [sh(l)] 
command whose output is to be read. For example, "$r !ls" 
appends current directory to the end of the file being edited. Such a 
shell command is not remembered as the current file name. 
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(,,,)s/RE /replacement/ or 

(,,. )s/ RE/ replacement /g or 

{.,,)s/RE /replacement /n n = 1-512 

The substitute command searches each addressed line for an 
occurrence of the specified RE. In each line in which a match is 
found, all (non-overlapped) matched strings are replaced by the 
replacement if the global replacement indicator g appears after the 
command. If the global indicator does not appear, only the first 
occurrence of the matched string is replaced. If a number n appears 
after the command, only the w-th occurrence of the matched string 
on each addressed line is replaced. It is an error for the substitution 
to fail on all addressed lines. Any character other than space or 
new-line may be used instead of / to delimit the RE and the replace- 
ment; , is left at the last line on which a substitution occurred. See 
also the last paragraph before FILES. 

An ampersand (&) appearing in the replacement is replaced by the 
string matching the RE on the current line. The special meaning of 
& in this context may be suppressed by preceding it by \. As a 
more general feature, the characters \n, where n is a digit, are 
replaced by the text matched by the «-th regular subexpression of 
the specified RE enclosed between \( and \). When nested 
parenthesized subexpressions are present, n is determined by count- 
ing occurrences of \( starting from the left. When the character % is 
the only character in the replacement, the replacement used in the 
most recent substitute command is used as the replacement in the 
current substitute command. The % loses its special meaning when 
it is in a replacement string of more than one character or is pre- 
ceded by a \. 

A line may be split by substituting a new-line character into it. The 
new-line in the replacement must be escaped by preceding it by \. 
Such substitution cannot be done as part of a g or i? command list. 

(.,.)tfl 

This command acts just like the m command, except that a copy of 
the addressed lines is placed after address a (which may be 0); . is 
left at the last line of the copy. 

u 

The wndo command nullifies the effect of the most recent command 
that modified anything in the buffer, namely the most recent a, c, d, 
g, i, j, m, r, s, t, V, G, or V command. 

(1 ,$)v/RE /command list 

This command is the same as the global command g except that the 
command list is executed with . initially set to every line that does 
not match the RE. 

(1,$)V/RE/ 

This command is the same as the interactive global command G 
except that the lines that are marked during the first step are those 
that do not match the RE. 
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(l,$)w///e 

The write command writes the addressed lines into the named file. 
If the file does not exist, it is created with mode 666 (readable and 
writable by everyone), unless your umask setting [see umask(l)] dic- 
tates otherwise. The currently remembered file name is not changed 
unless file is the very first file name mentioned since ed was 
invoked. If no file name is given, the currently remembered file 
name, if any, is used (see e and / commands); . is unchanged. If the 
command is successful, the number of characters written is typed. 
If file is replaced by !, the rest of the line is taken to be a shell 
[sfz(l)] command whose standard input is the addressed lines. Such 
a shell command is not remembered as the current file name. 

X 

A key is prompted for, and it is used in subsequent e, and w com- 
mands to decrypt and encrypt text using the crypt (1) algorithm. An 
educated guess is made to determine whether text read in for the e 
and r commands is encrypted. A null key turns off encryption. 
Subsequent e, r, and w commands will use this key to encrypt or 
decrypt the text [see crypt{\)]. An explicitly empty key turns off 
encryption. Also, see the -x option of ed, 

($)= 

The line number of the addressed line is typed; . is unchanged by 
this command. 

Xshell command 

The remainder of the line after the ! is sent to the UNIX system shell 
[s/i(l)] to be interpreted as a command. Within the text of that com- 
mand, the unescaped character % is replaced with the remembered 
file name; if a ! appears as the first character of the shell command, 
it is replaced with the text of the previous shell command. Thus, !! 
will repeat the last shell command. If any expansion is performed, 
the expanded line is echoed; . is unchanged. 

( .-f 1 )<new-line> 

An address alone on a line causes the addressed line to be printed. 
A new-line alone is equivalent to .+lp; it is useful for stepping for- 
ward through the buffer. 

If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ? and returns 
to its command level. 

Some size limitations: 512 characters in a line, 256 characters in a global 
command list, and 64 characters in the path name of a file (counting 
slashes). The limit on the number of lines depends on the amount of user 
memory: each line takes 1 word. 

When reading a file, ed discards ASCII NUL characters. 

If a file is not terminated by a new-line character, ed adds one and puts out 
a message explaining what it did. 

If the closing delimiter of a RE or of a replacement string (e.g., /) would be 
the last character before a new-line, that delimiter may be omitted, in which 
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case the addressed line is printed. The following pairs of commands are 
equivalent: 

s/sl/s2 s/sl/s2/p 
g/sl g/sl/p 
?sl ?sl? 

FILES 

$TMPDIR if this environmental variable is not null, its value is used in 
place of /usr/tmp as the directory name for the temporary 
work file. 

/usr/tmp if /usr/tmp exists, it is used as the directory name for the tem- 
porary work file. 

/tmp if the environmental variable TMPDIR does not exist or is null, 

and if /usr/tmp does not exist, then /tmp is used as the direc- 
tory name for the temporary work file. 

ed.hup work is saved here if the terminal is hung up. 

NOTES 

The - option, although it continues to be supported, has been replaced in 
the documentation by the -s option that follows the Command Syntax 
Standard [see intro(l)]. 

SEE ALSO 

edit(l), ex(l), grep(l), sed(l), sh(l), stty(l), umask(l), vi(l). 
fspec(4), regexp(5) in the Programmer's Reference Manual. 

DIAGNOSTICS 

? for command errors. 

Ifile for an inaccessible file. 

(use the help and Help commands for detailed explanations). 

If changes have been made in the buffer since the last w command that 
wrote the entire buffer, ed warns the user if an attempt is made to destroy 
ed's buffer via the e or q commands. It prints ? and allows one to continue 
editing. A second e ox q command at this point will take effect. The -s 
command-line option inhibits this feature. 

WARNINGS 

The encryption options and commands are provided with the Security 
Administration Utilities package, which is available only in the United 
States. 

BUGS 

A command cannot be subject to a g or a r command. 

The I command and the ! escape from the e, r, and w commands cannot be 
used if the editor is invoked from a restricted shell [see s/z(l)]. 

The sequence \n in a RE does not match a new-line character. 

If the editor input is coming from a command file (e.g., ed file < ed-cmd- 
file), the editor will exit at the first failure. 
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NAME 

edit - text editor (variant of ex for casual users) 

SYNOPSIS 

edit [-r] [-x] [-C] name ... 

DESCRIPTION 

edit is a variant of the text editor ex recommended for new or casual users 
v^ho v^ish to use a command-oriented editor. It operates precisely as ex(l) 
with the following options automatically set: 

novice ON 

report ON 

showmode ON 

magic OFF 

These options can be turned on or off via the set command in ex{l), 
-r Recover file after an editor or system crash. 

-X Encryption option; when used, the file will be encrypted as it is 
being written and will require an encryption key to be read, edit 
makes an educated guess to determine if a file is encrypted or not. 
See crypt(l). Also, see the WARNING section at the end of this 
manual page. 

-C Encryption option; the same as -x except that edit assumes files are 
encrypted. 

The following brief introduction should help you get started with edit. If 
you are using a CRT terminal you may want to learn about the display editor 
vi. 

To edit the contents of an existing file, you begin with the command edit 
name to the shell, edit makes a copy of the file that you can then edit, and 
tells you how many lines and characters are in the file. To create a new 
file, you also begin with the command edit with a filename: edit name; the 
editor will tell you it is a New File. 

The edit command prompt is the colon (:), which you should see after start- 
ing the editor. If you are editing an existing file, then you will have some 
lines in edit's buffer (its name for the copy of the file you are editing). 
When you start editing, edit makes the last line of the file the current line. 
Most commands to edit use the current line if you do not tell them which 
line to use. Thus if you say print (which can be abbreviated p) and type 
carriage return (as you should after all edit commands), the current line will 
be printed. If you delete (d) the current line, edit will print the new current 
line, which is usually the next line in the file. If you delete the last line, 
then the new last line becomes the current one. 

If you start with an empty file or wish to add some new lines, then the 
append (a) command can be used. After you execute this command (typing 
a carriage return after the word append), edit will read lines from your termi- 
nal until you type a line consisting of just a dot (.); it places these lines after 
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the current line. The last line you type then becomes the current line. The 
command insert (f) is like append, but places the lines you type before, 
rather than after, the current line. 

edit numbers the lines in the buffer, with the first line having number 1. If 
you execute the command 1, then edit will type the first line of the buffer. 
If you then execute the command d, edit will delete the first line, line 2 will 
become line 1, and edit will print the current line (the new line 1) so you 
can see where you are. In general, the current line will always be the last 
line affected by a command. 

You can make a change to some text within the current line by using the 
substitute (s) command: s/ old /new/ where old is the string of characters 
you want to replace and new is the string of characters you want to replace 
old with. 

The command file (J) will tell you how many lines there are in the buffer 
you are editing and will say [Modified] if you have changed the buffer. 
After modifying a file, you can save the contents of the file by executing a 
write (w) command. You can leave the editor by issuing a quit {q) com- 
mand. If you run edit on a file, but do not change it, it is not necessary (but 
does no harm) to write the file back. If you try to quit from edit after modi- 
fying the buffer without writing it out, you will receive the message No 
write since last change (:quit! overrides), and edit 
will wait for another command. If you do not want to write the buffer out, 
issue the quit command followed by an exclamation point {q\). The buffer is 
then irretrievably discarded and you return to the shell. 

By using the d and a commands and giving line numbers to see lines in the 
file, you can make any changes you want. You should learn at least a few 
more things, however, if you will use edit more than a few times. 

The change (c) command changes the current line to a sequence of lines you 
supply (as in append, you type lines up to a line consisting of only a dot (.). 
You can tell change to change more than one line by giving the line 
numbers of the lines you want to change, i.e., 3,5c. You can print lines this 
way too: l,23p prints the first 23 lines of the file. 

The undo (u) command reverses the effect of the last command you exe- 
cuted that changed the buffer. Thus if you execute a substitute command 
that does not do what you want, type u and the old contents of the line will 
be restored. You can also undo an undo command, edit will give you a 
warning message when a command affects more than one line of the buffer. 
Note that commands such as write and quit cannot be undone. 

To look at the next line in the buffer, type carriage return. To look at a 
number of lines, type D (while holding down the control key, press d) 
rather than carriage return. This will show you a half-screen of lines on a 
CRT or 12 lines on a hardcopy terminal. You can look at nearby text by 
executing the z command. The current line will appear in the middle of the 
text displayed, and the last line displayed will become the current line; you 
can get back to the line where you were before you executed the z com- 
mand by typing ". The z command has other options: z- prints a screen of 
text (or 24 lines) ending where you are; z+ prints the next screenful. If you 
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want less than a screenful of lines, type z.U to display five lines before and 
five lines after the current line. (Typing z.n, when n is an odd number, 
displays a total of n lines, centered about the current line; when n is an 
even number, it displays n-1 lines, so that the lines displayed are centered 
around the current line.) You can give counts after other commands; for 
example, you can delete 5 lines starting with the current line with the com- 
mand d5. 

To find things in the file, you can use line numbers if you happen to know 
them. Since the line numbers change when you insert and delete lines, this 
is somewhat unreliable. You can search backward and forward in the file 
for strings by giving commands of the form /text/ to search forward for text 
or Itextl to search backward for text. If a search reaches the end of the file 
without finding text, it wraps around and continues to search back to the 
line where you are. A useful feature here is a search of the form / text/ 
which searches for text at the beginning of a line. Similarly /text%/ 
searches for text at the end of a line. You can leave off the trailing / or ? in 
these commands. 

The current line has the symbolic name dot (.); this is most useful in a range 
of lines as in .,$p which prints the current line plus the rest of the lines in 
the file. To move to the last line in the file, you can refer to it by its sym- 
bolic name $. Thus the command $d deletes the last line in the file, no 
matter what the current line is. Arithmetic with line references is also possi- 
ble. Thus the line $-5 is the fifth before the last and .+20 is 20 lines after 
the current line. 

You can determine the current line by typing .= . This is useful if you wish 
to move or copy a section of text within a file or between files. Find the 
first and last line numbers you wish to copy or move. To move lines 10 
through 20, type 10,20d a to delete these lines from the file and place them 
in a buffer named a. edit has 26 such buffers named a through z. To put 
the contents of buffer a after the current line, type iput a. If you want to 
move or copy these lines to another file, execute an edit (e) command after 
copying the lines; following the e command with the name of the other file 
you wish to edit, i.e., edit chapter!. To copy lines without deleting them, 
use yank (y) in place of d. If the text you wish to move or copy is all within 
one file, it is not necessary to use named buffers. For example, to move 
lines 10 through 20 to the end of the file, type 10,20m $. 

SEE ALSO 

ed(l), ex(l), vi(l). 

WARNING 

The encryption options are provided with the Security Administration Utili- 
ties package, which is available only in the United States. 
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NAME 

egrep - search a file for a pattern using full regular expressions 
SYNOPSIS 

egrep [options] full regular expression [file ...] 
DESCRIPTION 

The egrep command {expression grep) searches files for a pattern of charac- 
ters and prints all lines that contain that pattern, egrep uses full regular 
expressions (expressions that have string values that use the full set of 
alphanumeric and special characters) to match the patterns. It uses a fast 
deterministic algorithm that sometimes needs exponential space. 
The egrep command accepts full regular expressions as in ed{l), except for 
\( and \), with the addition of: 

1. A full regular expression followed by + that matches one or more 
occurrences of the full regular expression. 

2. A full regular expression followed by ? that matches or 1 
occurrences of the full regular expression. 

3. Full regular expressions separated by | or by a new-line that match 
strings that are matched by any of the expressions. 

4. A full regular expression that may be enclosed in parentheses () for 
grouping. 

Be careful using the characters $, *, [, \ |, (, ), and \ in full regular expres- 
sion, because they are also meaningful to the shell. It is safest to enclose 
the entire full regular expression in single quotes 

The order of precedence of operators is [], then *?+, then concatenation, 
then I and new-line. 

If no files are specified, egrep assumes standard input. Normally, each line 
found is copied to the standard output. The file name is printed before each 
line found if there is more than one input file. 

Command line options are: 

-b Precede each line by the block number on which it was found. This 
can be useful in locating block numbers by context (first block is 0). 

-c Print only a count of the lines that contain the pattern. 

-i Ignore upper/lower case distinction during comparisons. 

-1 Print the names of files with matching lines once, separated by new- 
lines. Does not repeat the names of files when the pattern is found 
more than once. 

-n Precede each line by its line number in the file (first line is 1). 
-V Print all lines except those that contain the pattern, 
-e special— expression 

Search for a special expression (full regular expression that begins with 

a-). 

-i file Take the list of full regular expressions from file. 

-h Prevents the name of the file containing the matching lines from 
being appended to that line. Used when searching multiple files. 
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SEE ALSO 

ed(l), fgrep(l), grep(l), sed(l), sh(l). 

DIAGNOSTICS 

Exit status is if any matches are found, 1 if none, 2 for syntax errors or 
inaccessible files (even if matches were found). 

BUGS 

Ideally, there should be only one grep command, but there is not a single 
algorithm that spans a wide enough range of space-time tradeoffs. Lines 
are limited to BUFSIZ characters; longer lines are truncated. BUFSIZ is 
defined in /usr/include/stdio.h, which is included as part of the basic 
software development set. 
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NAME 

enable, disable - enable/disable LP printers 

SYNOPSIS 

enable printers 

disable [options] printers 

DESCRIPTION 

The enable command activates the named printers, enabling them to print 
requests taken by lp{l). Use lpstat(l) to find the status of printers. 

The disable command deactivates the named printers, disabling them from 
printing requests taken by lp(l). By default, any requests that are currently 
printing on the designated printers will be reprinted in their entirety either 
on the same printer or on another member of the same class. Use lpstat(l) 
to find the status of printers. Options for use with disable are: 

-c Cancel any requests that are currently printing on any of the 

designated printers. This option cannot be used with the -W 
option. 

-r reason Assign a reason for the disabling of the printers. This reason 
applies to all printers mentioned up to the next -r option. This 
reason is reported by lpstat(l). If the -r option is not present, 
then a default reason will be used. 

-W Disable the specified printers when the print requests currently 

printing have finished. This option cannot be used with the -c 
option. 

FILES 

/usr/spool/lp/* 

SEE ALSO 

lp(l), Ipstat(l). 



ENV(l) 



(Base System) 



ENV(l) 



NAME 

env - set environment for command execution 
SYNOPSIS 

env [-] [ name= value ] ... [ command args ] 
DESCRIPTION 

The env command obtains the current environment, modifies it according to 
its arguments, then executes the command with the modified environment. 
Arguments of the form name=value are merged into the inherited environ- 
ment before the command is executed. The - flag causes the inherited 
environment to be ignored completely, so that the command is executed 
with exactly the environment specified by the arguments. 

If no command is specified, the resulting environment is printed, one 
name-value pair per line. 

SEE ALSO 

sh(l). 

exec(2), profile(4), environ(5) in the Programmer's Reference Manual. 
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NAME 

ex - text editor 
SYNOPSIS 

ex [-S] [-V] [-t tag] [-r file] [-L] [-R] [-x] [-C] [-c command] file . . . 
DESCRIPTION 

ex is the root of a family of editors: ex and vi. ex is a superset of ed, with 
the most notable extension being a display editing facility. Display-based 
editing is the focus of vi. 

If you have a CRT terminal, you may wish to use a display-based editor; in 
this case see vi(l), which is a command which focuses on the display- 
editing portion of ex. 

For ed Users 

If you have used ed{l), you will find that, in addition to having all of the 
ed{l) commands available, ex has a number of additional features useful on 
CRT terminals. Intelligent terminals and high-speed terminals are very 
pleasant to use with vi. Generally, the ex editor uses far more of the capa- 
bilities of terminals than ed(l) does and uses the terminal capability data 
base [see terminfo(A)] and the type of the terminal you are using from the 
environmental variable TERM to determine how to drive your terminal effi- 
ciently. The editor makes use of features such as insert and delete character 
and line in its visual command (which can be abbreviated vi) and which is 
the central mode of editing when using vi(l). 

ex contains a number of features for easily viewing the text of the file. The 
z command gives easy access to windows of text. Typing D (control-d) 
causes the editor to scroll a half-window of text and is more useful for 
quickly stepping through a file than just typing return. Of course, the 
screen-oriented visual mode gives constant access to editing context. 

ex gives you help when you make mistakes. The undo (u) command allows 
you to reverse any single change which goes astray, ex gives you a lot of 
feedback, normally printing changed lines, and indicates when more than a 
few lines are affected by a command so that it is easy to detect when a 
command has affected more lines than it should have. 

The editor also normally prevents overwriting existing files, unless you 
edited them, so that you do not accidentally overwrite a file other than the 
one you are editing. If the system (or editor) crashes, or you accidentally 
hang up the telephone, you can use the editor recover command (or -r file 
option) to retrieve your work. This will get you back to within a few lines 
of where you left off. 

ex has several features for dealing with more than one file at a time. You 
can give it a list of files on the command line and use the next (n) command 
to deal with each in turn. The next command can also be given a list of file 
names or a pattern as used by the shell to specify a new set of files to be 
dealt with. In general, file names in the editor may be formed with full 
shell metasyntax. The metacharacter is also available in forming file 
names and is replaced by the name of the current file. 



- 1 - 



EX(1) 



(Editing Package) 



EX(1) 



The editor has a group of buffers whose names are the ASCII lower-case 
letters (a-z). You can place text in these named buffers where it is available 
to be inserted elsewhere in the file. The contents of these buffers remain 
available when you begin editing a new file using the edit (e) command. 

There is a command & in ex which repeats the last substitute command. In 
addition, there is a confirmed substitute command. You give a range of 
substitutions to be done and the editor interactively asks whether each sub- 
stitution is desired. 

It is possible to ignore the case of letters in searches and substitutions, ex 
also allows regular expressions which match words to be constructed. This 
is convenient, for example, in searching for the word "edit" if your docu- 
ment also contains the word "editor." 

ex has a set of options which you can set to tailor it to your liking. One 
option which is very useful is the autoindent option that allows the editor 
to supply leading white space to align text automatically. You can then use 
D as a backtab and space or tab to move forward to align new code easily. 

Miscellaneous useful features include an intelligent join {j) command that 
supplies white space between joined lines automatically, commands "<" 
and ">" which shift groups of lines, and the ability to filter portions of the 
buffer through commands such as sort(l). 

Invocation Options 

The following invocation options are interpreted by ex (previously docu- 
mented options are discussed in the NOTES section at the end of this 
manual page): 

-s Suppress all interactive-user feedback. This is useful in 

processing editor scripts. 

-V Invoke vi 

-t tag Edit the file containing the tag and position the editor at its 

definition. 

-r file Edit file after an editor or system crash. (Recovers the ver- 

sion of file that was in the buffer when the crash occurred.) 

-L List the names of all files saved as the result of an editor or 

system crash. 

-R Readonly mode; the readonly flag is set, preventing 

accidental overwriting of the file. 

-x Encryption option; when used, ex simulates an X command 

and prompts the user for a key. This key is used to 
encrypt and decrypt text using the algorithm of crypt(l). 
The X command makes an educated guess to determine 
whether text read in is encrypted or not. The temporary 
buffer file is encrypted also, using a transformed version of 
the key typed in for the -x option. [See crypt{l)]. Also, 
see the WARNINGS section at the end of this manual page. 
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-C Encryption option; the same as the -x option, except that ex 

simulates a C command. The C command is like the X 
command, except that all text read in is assumed to have 
been encrypted. 

-c command Begin editing by executing the specified editor command 
(usually a search or positioning command). 

The file argument indicates one or more files to be edited. 

ex States 

Command Normal and initial state. Input prompted for by :. Your 
line kill character cancels a partial command. 

Insert Entered by a, i, or c. Arbitrary text may be entered. Insert 

state normally is terminated by a line having only "." on 
it, or, abnormally, with an interrupt. 

Visual Entered by typing vi; terminated by typing Q or \ 

(control-\). 

ex Command Names and Abbreviations 



abbrev 


ab 


map 




set 


se 


append 


a 


mark 


ma 


shell 


sh 


args 


ar 


move 


m 


source 


so 


change 


c 


next 


n 


substitute 


s 


copy 


CO 


number 


nu 


unabbrev 


unab 


delete 


d 


preserve 


pre 


undo 


u 


edit 


e 


print 


P 


unmap 


unm 


file 


f 


put 


pu 


version 


ve 


global 
insert 


g 
i 


quit 


q 


visual 


vi 


read 


r 


write 


w 


join 


) 


recover 


rec 


xit 


X 


list 


1 


rewind 


rew 


yank 


ya 



ex Commands 

forced encryption 
resubst 
rshift 
scroll 

shell escape 
ex Command Addresses 



C 
& 
> 
D 



heuristic encryption X 

print next CR 

Ishift < 

window z 



n 


line n 


/pat 


next with pat 




current 


7pat 


previous with pat 


$ 


last 


x-n 


n before x 


+ 


next 


x,y 


X through 1/ 




previous 


'X 


marked with x 


+n 
% 


n forward 
1,$ 


II 


previous context 



Initializing options 
EXINIT 
$HOME/.exrc 
./.exrc 



place set's here in environment variable 
editor initialization file 
editor initialization file 
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set X 
set nox 
set x=val 
set 

set all 

set X? 

Most useful options 
autoindent 
autowrite 
directory 
exrc 



ignorecase 
list 
magic 
modelines 



number 
paragraphs 
redraw 
report 



scroll 

sections 

shiftwidth 

showmatch 

showmode 

slowopen 

term 



enable option x 
disable option x 
give value val to option x 
show changed options 
show all options 
show value of option x 

and their abbreviations 



ai 
aw 
dir 
ex 



ic 



nu 
para 



sect 

sw 

sm 

smd 

slow 



window 

wrapmargin wm 
wrapscan ws 

Scanning pattern formation 



supply indent 

write before changing files 

specify the directory 

allow vi/ex to read the .exrc in the current 
directory. This option is set in the 
EXINIT shell variable or in the .exrc file 
in the $HOME directory. 

ignore case of letters in scanning 

print I for tab, $ at end 

treat . [ * special in patterns 

first five lines and last five lines executed as 
vi/ex commands if they are of the form 
exicommand: or viicommand: 

number lines 

macro names that start paragraphs 

simulate smart terminal 

informs you if the number of lines modified 

by the last command is greater than the 

value of the report variable 
command mode lines 
macro names that start sections 
for < >, and input D 
to ) and } as typed 
show insert mode in vi 
stop updates during insert 
specifies to vi the type of terminal 

being used (the default is the value 

of the environmental variable TERM) 
visual mode lines 
automatic line splitting 
search around end (or beginning) of buffer 





beginning of line 


$ 


end of line 




any character 


\< 


beginning of word 


\> 


end of word 




any character in str 


[sfr] 


any character not in str 


l^-y] 


any character between x and y 


* 


any number of preceding characters 
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NOTES 



AUTHOR r i r • 

vi and ex are based on software developed by The University of California, 
Berkeley, California, Computer Science Division, Department of Electrical 
Engineering and Computer Science. 

FILES 

/usr /lib /exstrings error messages 

/usr /lib /exrecover recover command 

/usr/lib/expreserve preserve command 

/usr/lib/terminfo/* describes capabilities of terminals 

$HOME/.exrc editor startup file 

./.exrc editor startup file 

/ imp /Exnnnnn editor temporary 

/ imp /Rxnnnnn named buffer temporary 

/usr/preserve//ogfn preservation directory 

(where login is the user's login) 

Several options, although they continue to be supported, have been 
replaced in the documentation by options that follow the Command Syntax 
Standard [see intro(l)l The - option has been replaced by -s, a -r option 
that is not followed with an option-argument has been replaced by -L, and 
^command has been replaced by -c command, 

SEE ALSO 

crypt(l), ed(l), edit(l), grep(l), sed(l), sort(l), vi(l). 

curses(3X), term(4), terminfo(4) in the Programmer's Reference Manual 

User's Guide. 

"curses/terminfo" chapter of the Programmer's Guide. 

WARNINGS ^ ^ . 1. 1. ^ 

The encryption options and commands are provided with the becurity 
Administration Utilities package, which is available only in the United 
States. 

BUGS 

The 2 command prints the number of logical rather than physical lines. 
More than a screen full of output may result if long lines are present. 
File input/output errors do not print a name if the command line -s option 
is used. 

There is no easy way to do a single scan ignoring case. 

The editor does not warn if text is placed in named buffers and not used 

before exiting the editor. 

Null characters are discarded in input files and cannot appear in resultant 
files. 
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NAME 

expr - evaluate arguments as an expression 

SYNOPSIS 

expr arguments 

DESCRIPTION 

The arguments are taken as an expression. After evaluation, the result is 
written on the standard output. Terms of the expression must be separated 
by blanks. Characters special to the shell must be escaped. Note that is 
returned to indicate a zero value, rather than the null string. Strings con- 
taining blanks or other special characters should be quoted. Integer-valued 
arguments may be preceded by a unary minus sign. Internally, integers are 
treated as 32-bit, 2s complement numbers. 

The operators and keywords are listed below. Characters that need to be 
escaped are preceded by \. The list is in order of increasing precedence, 
with equal precedence operators grouped within { } symbols. 

expr\ \ expr 

returns the first expr if it is neither null nor 0, otherwise returns the 
second expr. 

expr \& expr 

returns the first expr if neither expr is null or 0, otherwise returns 0. 

expr { =, \>, \>=, \<, \<=, != } expr 

returns the result of an integer comparison if both arguments are 
integers, otherwise returns the result of a lexical comparison. 

expr { +, - } expr 

addition or subtraction of integer-valued arguments. 

expr { \*, /, o/o } expr 

multiplication, division, or remainder of the integer-valued argu- 
ments. 

expr : expr 

The matching operator : compares the first argument with the 
second argument which must be a regular expression. Regular 
expression syntax is the same as that of ed{l), except that all pat- 
terns are "anchored" (i.e., begin with ^) and, therefore, ^ is not a 
special character, in that context. Normally, the matching operator 
returns the number of characters matched (0 on failure). Alterna- 
tively, the \(...\) pattern symbols can be used to return a portion 
of the first argument. 
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EXAMPLES 

1. a=''expr $a + 1' 

adds 1 to the shell variable a. 

2. # 'For $a equal to either "/usr/abc/file" or just "file"' 
expr $a : '.V\(-*\)' \| $a 

returns the last segment of a path name (i.e., file). Watch 
out for / alone as an argument: expr will take it as the divi- 
sion operator (see BUGS below). 



3. # A better representation of example 2. 
expr //$a : '.*/\(.*\)' 

The addition of the // characters eliminates any ambiguity 
about the division operator and simplifies the whole expres- 
sion. 



4. expr $VAR : '.*' 

returns the number of characters in $VAR. 



SEE ALSO 

ed(l), sh(l). 

DIAGNOSTICS 

As a side effect of expression evaluation, expr returns the following exit 
values: 

if the expression is neither null nor 

1 if the expression is null or 

2 for invalid expressions. 

syntax error for operator /operand errors 

non-numeric argument if arithmetic is attempted on such a string 



BUGS 



After argument processing by the shell, expr cannot tell the difference 
between an operator and an operand except by the value. If $a is an =, the 
command: 

expr $a = '=' 
looks like: 

expr = = = 

as the arguments are passed to expr (and they will all be taken as the = 
operator). The following works: 

expr X$a = X= 
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NAME 

factor - obtain the prime factors of a number 

SYNOPSIS 

factor [ integer ] 

DESCRIPTION 

When you use factor without an argument, it waits for you to give it an 
integer. After you give it a positive integer less than or equal to 10^^, it fac- 
tors the integer, prints its prime factors the proper number of times, and 
then waits for another integer, factor exits if it encounters a zero or any 
non-numeric character. 

If you invoke factor with an argument, it factors the integer as described 
above, and then it exits. 

The maximum time to factor an integer is proportional to ]/n. factor will 
take this time when n is prime or the square of a prime. 

DIAGNOSTICS 

factor prints the error message, "Ouch," for input out of range or for gar- 
bage input. 
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NAME 

fdisk - create or modify hard disk partition table 

SYNOPSIS 

fdisk [ argument ] 

DESCRIPTION 

This command is used to create and modify the partition table that is put in 
the first sector of the hard disk. This table is used by DOS and by the 
first-stage bootstrap to identify parts of the disk reserved for different 
operating systems, and to identify the partition containing the second-stage 
bootstrap (the active partition). The optional argument can be used to 
specify the raw device associated with the hard disk; the default value is 
/dev/rdsk/OsO. 

The program displays the partition table as it exists on the disk, and then 
presents a menu allowing the user to modify the table. The menu, ques- 
tions, warnings, and error messages are intended to be self-explanatory. 

If there is no partition table on the disk, the user is given the option of 
creating a default partitioning or specifying the initial table values. The 
default partitioning allows 10% of the disk for MS-DOS and 90% for the 
UNIX system, and makes the UNIX system partition active. In either case, 
when the initial table is created, fdisk also writes out the first-stage bootstrap 
code [see hd(7)] along with the partition table. After the initial table is 
created, only the table is changed; the bootstrap is not modified. 

Menu Options 

The following are the menu options given by the fdisk program: 

Create a partition 

This option allows the user to create a new partition. The max- 
imum number of partitions is 4. The program will ask for the type 
of the partition (MS-DOS, UNIX system, or other). It will then ask 
for the size of the partition as a percentage of the disk. The user 
may also enter the letter c at this point, in which case the program 
will ask for the starting cylinder number and size of the partition in 
cylinders. If a c is not entered, the program will determine the 
starting cylinder number where the partition will fit. In either case, 
if the partition would overlap an existing partition, or will not fit, a 
message is displayed and the program returns to the original menu. 

Change Active (Boot from) partition 

This option allows the user to specify the partition where the first- 
stage bootstrap will look for the second-stage bootstrap, otherwise 
known as the active partition. 

Delete a partition 

This option allows the user to delete a previously created partition. 
Note that this will destroy all data in that partition. 

Exit This option writes the new version of the table created during this 
session with fdisk out to the hard disk, and exits the program. 
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Cancel This option exits without modifying the partition table. 
DIAGNOSTICS 

Most messages will be self-explanatory. The following may appear immedi- 
ately after starting the program: 

Fdisk: cannot open <device> 

This indicates that the device name argument is not valid. 

Fdisk: unable to get device parameters for device <device> 

This indicates a problem with the configuration of the hard disk, or 
an error in the hard disk driver. 

Fdisk: error reading partition table 

This indicates that some error occurred when trying initially to read 
the hard disk. This could be a problem with the hard disk con- 
troller or driver, or with the configuration of the hard disk. 

This message may appear after selecting the Exit option from the menu. 

Fdisk: error writing boot record 

This indicates that some error occurred when trying to write the 
new partition table out to the hard disk. This could be a problem 
with the hard disk controller, the disk itself, the driver, or the confi- 
guration of the hard disk. 

FILES 

/dev/rdsk/OsO 

SEE ALSO 

mkpart(lM), disk(7), hd(7). 

WARNING 

Compatible with MS-DOS Version 3.2. 
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NAME 

ff - list file names and statistics for a file system 

SYNOPSIS 

/etc/ff [options] special 

DESCRIPTION 

The ff command reads the i-list and directories of the special file, assuming 
it is a file system. Inode data is saved for files which match the selection 
criteria. Output consists of the path name for each saved inode, plus other 
file information requested using the print options belov^. Output fields are 
positional. The output is produced in inode order; fields are separated by 
tabs. The default line produced by // is: 

path-name i-number 

With all options enabled, output fields v^ould be: 
path-name i-number size uid 

The argument n in the option descriptions that follow is used as a decimal 
integer (optionally signed), where +n means more than n, -n means less 
than n, and n means exactly n. A day is defined as a 24-hour period. 



-I Do not print the inode number after each path name. 

-1 Generate a supplementary list of all path names for multiple- 

linked files. 

-p prefix The specified prefix will be added to each generated path 
name. The default is . (dot). 

-s Print the file size, in bytes, after each path name. 

-u Print the owner's login name after each path name. 

-a n Select if the inode has been accessed in n days. 

-m n Select if the inode has been modified in n days. 

-c n Select if the inode has been changed in n days. 

-n file Select if the inode has been modified more recently than the 

argument file. 



-i inode-list Generate names for only those inodes specified in inode-list. 

SEE ALSO 

find(l), ncheck(lM). 

BUGS 

If the -1 option is not specified, only a single path name out of all possible 
ones is generated for a multiple-linked inode. If -1 is specified, all possible 
names for every linked file on the file system are included in the output. 
However, no selection criteria apply to the names generated. 
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NAME 

fgrep - search a file for a character string 

SYNOPSIS 

fgrep [options] string [file ...] 

DESCRIPTION 

The fgrep (fast grep) command searches files for a character string and 
prints all lines that contain that string, fgrep is different from grep(l) and 
egrep(l) because it searches for a string, instead of searching for a pattern 
that matches an expression. It uses a fast and compact algorithm. 

The characters $,*,[, , |, (, ), and \ are interpreted literally by fgrep, that 
is, fgrep does not recognize full regular expressions as does egrep . Since 
these characters have special meaning to the shell, it is safest to enclose the 
entire string in single quotes 

If no files are specified, fgrep assumes standard input. Normally, each line 
found is copied to the standard output. The file name is printed before each 
line found if there is more than one input file. 

Command line options are: 

-b Precede each line by the block number on which it was found. This 
can be useful in locating block numbers by context (first block is 0). 

-c Print only a count of the lines that contain the pattern. 

-i Ignore upper/lower case distinction during comparisons. 

-1 Print the names of files with matching lines once, separated by new- 
lines. Does not repeat the names of files when the pattern is found 
more than once. 

-n Precede each line by its line number in the file (first line is 1). 
-V Print all lines except those that contain the pattern. 
-X Print only lines matched entirely, 
-e special—String 

Search for a special string (string begins with a -). 
file Take the list of strings horn file. 
-h Prevents the name of the file containing the matching line from being 

appended to that line. Used when searching multiple files. 

SEE ALSO 

ed(l), egrep(l), grep(l), sed(l), sh(l). 

DIAGNOSTICS 

Exit status is if any matches are found, 1 if none, 2 for syntax errors or 
inaccessible files (even if matches were found). 

BUGS 

Ideally there should be only one grep command, but there is not a single 
algorithm that spans a wide enough range of space-time tradeoffs. Lines 
are limited to BUFSIZ characters; longer lines are truncated. BUFSIZ is 
defined in /usr/include/stdio.h, which is included as part of the basic 
software development set. 
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NAME 

file - determine file type 
SYNOPSIS 

file [ -c ] [ -f ffile ] [ -m mfile ] arg ... 
DESCRIPTION 

The file command performs a series of tests on each argument in an attempt 
to classify it. If an argument appears to be ASCII, file examines the first 512 
bytes and tries to guess its language. If an argument is an executable a.out, 
file will print the version stamp, provided it is greater than 0. 

-c The -c option causes file to check the magic file for format errors. 
This validation is not normally carried out for reasons of efficiency. 
No file typing is done under -c. 

-f If the -f option is given, the next argument is taken to be a file con- 
taining the names of the files to be examined. 

-m The -m option instructs file to use an alternate magic file. 

The file command uses the file /etc/magic to identify files that have some 
sort of magic number, that is, any file containing a numeric or string con- 
stant that indicates its type. Commentary at the beginning of /etc/magic 
explains its format. 

FILES 

/etc/magic 
SEE ALSO 

filehdr(4) in the Programmer's Reference Manual. 
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NAME 

find - find files 

SYNOPSIS 

find path-name-list expression 

DESCRIPTION 

The find command recursively descends the directory hierarchy for each 
path name in the path-name-list (that is, one or more path names), seeking 
files that match a Boolean expression written in the primaries given below. 
In the descriptions, the argument n is used as a decimal integer where -f n 
means more than w, -n means less than «, and n means exactly n. Valid 
expressions are: 

-name file True if file matches the current file name. Normal shell 

argument syntax may be used if escaped (watch out for [, 
? and *). 

[-perm] -onum True if the file permission flags exactly match the octal 
number onum [see chmod{l)]. If onum is prefixed by a 
minus sign, only the bits that are set in onum are com- 
pared with the file permission flags, and the expression 
evaluates true if they match. 

-type c True if the type of the file is c, where c is b, c, d, p, or f 

for block special file, character special file, directory, fifo 
(a.k.a named pipe), or plain file, respectively. 

-links n True if the file has n links. 

-user uname True if the file belongs to the user uname. If uname is 
numeric and does not appear as a login name in the 
/etc/passwd file, it is taken as a user ID. 

-group gname True if the file belongs to the group gname. If gname is 
numeric and does not appear in the /etc/group file, it is 
taken as a group ID. 

-size n[c] True if the file is n blocks long (512 bytes per block). If n 

is followed by a c, the size is in characters. 

-atime n True if the file has been accessed in n days. The access 

time of directories in path-name-list is changed by find 
itself. 

-mtime n True if the file has been modified in n days. 

-ctime n True if the file has been changed in n days. 

-exec cmd True if the executed cmd returns a zero value as exit 

status. The end of cmd must be punctuated by an escaped 
semicolon. A command argument {} is replaced by the 
current path name. 

-ok cmd Like -exec except that the generated command line is 

printed with a question mark first and is executed only if 
the user responds by typing y. 
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-print 
-cpio device 



Always true; causes the current path name to be printed. 



-newer file 



Always true; write the current file on device in cpio (1) for- 
mat (5120-byte records). 

True if the current file has been modified more recently 
than the argument file . 



-depth 



Always true; causes descent of the directory hierarchy to 
be done so that all entries in a directory are acted on 
before the directory itself. This can be useful when find is 
used with cpio{l) to transfer files that are contained in 
directories without write permission. 



-mount 



Always true; restricts the search to the file system contain- 
ing the directory specified, or if no directory was specified, 
the current directory. 



-local 



True if the file physically resides on the local system. 



( expression ) 



True if the parenthesized expression is true (parentheses 
are special to the shell and must be escaped). 



The primaries may be combined using the following operators (in order of 
decreasing precedence): 



(1) 


The negation of a primary (! is the unary not operator). 


(2) 


Concatenation of primaries (the and operation is implied by the juxta- 




position of two primaries). 


(3) 


Alternation of primaries (-o is the or operator). 


EXAMPLE 




To 


remove all files named a.out or *.o that have not been accessed for a 


week: 



find / \( -name a.out -o -name '*.o' \) -atime +7 -exec rm {} \; 

FILES 

/etc/passwd, /etc/group 

SEE ALSO 

chmod(l), cpio(l), sh(l), test(l). 

stat(2), umask(2), fs(4) in the Programmer's Reference Manual 

BUGS 

find / -depth always fails with the message: ''find: stat failed: : No such 
file or directory". 
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NAME 

fixperm - correct or initialize XENIX file permissions and ownership 
SYNOPSIS 

fixperm [-acDfgilnSsvw[-d^flc/cfl^e] [-u package]] specfile 
DESCRIPTION 

For each line in the specification file specfile, fixperm makes the listed path- 
name conform to a specification, fixperm is typically used by the super-user 
to configure a XENIX system upon installation. It has been provided for use 
with any existing XENIX packages that you may have that you wish to 
install on the UNIX system. Nonsuper-users can only use fixperm with the 
-D, -f, -1, or -n options. 

The following options are available: 

Option Description 

-a All files in the perm file must exist. This means that files 

marked as optional (type letter is in capital letters) must be 
present. 

-c Creates empty files and missing directories. 

-D Lists directories only on standard output. Does not modify 

target files. 

-dpackage Processes input lines beginning with given package specifier 
string (see above). For instance, -dBASE processes only 
items specified as belonging to the Basic utilities set. The 
default action is to process all lines. 

-f Lists files only on standard output. Does not modify target 

files. 

-g Lists all devices on the standard output. Target files are not 

modified (analogous to -1, -f, and -D). 

-i Checks to see if the selected packages are installed. Return 

values are 

0: package completely installed 

4: package not installed 

5: package partially installed 

If the equivalent package was installed as a UNIX package, -i 
will not detect it. 

-1 Lists files and directories on standard output. Does not 

modify target files. 

-n Reports errors only. Does not modify target files. 

-S Issues a complaint if files are not in x.out format. 

-s Modifies special device files in addition to the rest of the 

permlist. 
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-u package Causes similar action to -d option but processes items that 
are not part of the given package. 

-V (verbose) Issues a complaint if executable files are 1) word-swapped, 2) 
not fixed-stack, 3) not separate I and D, or 4) not stripped. 

-w Lists location (volume number) of the specified files or direc- 

tories. 

Specification File Format 

Each nonblank line in the specification file consists of either a comment or 
an item specification. A comment is any text from a pound sign up to 
the end of the line. There is one item specification per line. User and 
group id numbers must be specified at the top of the specification file for 
each user and group mentioned in the file. 

An item specification consists of a package specifier, a permission specifica- 
tion, owner and group specifications, the number of links on the file, the 
filename, and an optional volume number. 

The package specifier is an arbitrary string that is the name of a package 
within a distribution set. A package is a set of files. 

A permission specification follows the package specifier. The permission 
specification consists of a file type, followed by a numeric permission specif- 
ication. The item specification is one of the following characters: 



Character Description 

X executable 

a archive 

e empty file (create if -c option given) 

b block device 

c character device 

d directory 

f text file 

p named pipe 



If the item specification is given as an uppercase letter, the file associated 
with it is optional, and fixperm will not return an error message if it does 
not exist. 

The numeric permission conforms to the scheme described in chmod{l). 
The owner and group permissions are in the third column separated by a 
slash, such as ''bin/bin". The fourth column indicates the number of links. 
If there are links to the file, the next line contains the linked filename with 
no other information. The fifth column is a pathname. The pathname must 
be relative (not preceded by a slash The sixth column is only used for 

special files, major and minor device numbers, or volume numbers. 

EXAMPLES 

The following two lines make a distribution and invoke tar(l) to archive 
only the files in my_package on /dev/sample: 
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/etc/fixperm -f /etc/penn/my_package> list 
tar cfF /dev/sample list 

This command line reports package errors: 
/etc/fixperm -nd my_package 

NOTES 

fixperm is usually only run by a shell script at installation. 

fixperm should only be run from the directory to which the target files are 
relative. 

SEE ALSO 

custom(lM). 
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NAME 

format - format floppy disk tracks 
SYNOPSIS 

/bin/format [-vVE] [-f first] [-1 last] [-i interleave] device[t] 
DESCRIPTION 

The format command formats floppy disks. Unless otherwise specified, for- 
matting starts at track and continues until an error is returned at the end 
of a partition. 

The -f and -1 options specify the first and last track to be formatted. The 
default interleave of 2 may be modified by using the -i option. Device must 
specify a raw (character) floppy device. The t indicates the entire disk. 
Absence of this letter indicates that the first track of the diskette cannot be 
accessed. 

-V verbose. 

-V verify. After tracks are formatted, a random sector is chosen and 

a write of test data is done into it. The sector is then read back 
and a comparison is made. 

-E exhaustive verify. Every sector is verified by 

write /read /compare. 

FILES 

/dev/rdsk/* raw device for partition to be formatted 

SEE ALSO 

mkpart(lM), fd(7). 
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NAME 

fsck, dfsck - check and repair file systems 
SYNOPSIS 

/etc/fsck [-y] [-n] [-sX] [-SX] [-t file] [-q] [-D] [-f] [-b] [file-systems] 
/etc/dfsck [optionsl] fsysl ... - [options2] fsys2 ... 

DESCRIPTION 
fsck 

The fsck command audits and interactively repairs inconsistent conditions 
for file systems. If the file system is found to be consistent, the number of 
files, blocks used, and blocks free are reported. If the file system is incon- 
sistent, the user is prompted for concurrence before each correction is 
attempted. It should be noted that most corrective actions will result in 
some loss of data. The amount and severity of data loss may be determined 
from the diagnostic output. The default action for each correction is to wait 
for the user to respond yes or no. If the user does not have write permis- 
sion, fsck defaults to a -n action. 

The following options are accepted by fsck: 

-y Assume a yes response to all questions asked by fsck. 

-n Assume a no response to all questions asked by fsck; do not open the 
file system for writing. 

-sX Ignore the actual free list and (unconditionally) reconstruct a new one 
by rewriting the super block of the file system. The file system 
should be unmounted while this is done; if this is not possible, care 
should be taken that the system is quiescent and that it is rebooted 
immediately afterwards. This precaution is necessary so that the old, 
bad, in -core copy of the super block will not continue to be used, or 
written on the file system. 

The -sX option allows for creating an optimal free-list organization. 

If X is not given, the values used when the file system was created 
are used. The format of X is cylinder sizeigap size. 

-SX Conditionally reconstruct the free list. This option is like -sX above 
except that the free list is rebuilt only if there were no discrepancies 
discovered in the file system. Using -S will force a no response to all 
questions asked by fsck. This option is useful for forcing free list 
reorganization on uncontaminated file systems. 

-t If fsck cannot obtain enough memory to keep its tables, it uses a 
scratch file. If the -t option is specified, the file named in the next 
argument is used as the scratch file, if needed. Without the -t flag, 
fsck will prompt the user for the name of the scratch file. The file 
chosen should not be on the file system being checked, and if it is 
not a special file or did not already exist, it is removed when fsck 
completes. 

-q Quiet fsck. Do not print size-check messages. Unreferenced fifos will 
silently be removed. If fsck requires it, counts in the super block will 
be automatically fixed and the free list salvaged. 
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-D Directories are checked for bad blocks. Useful after system crashes. 

-f Fast check. Check block and sizes and check the free list. The free 
list will be reconstructed, if necessary. 

-b Reboot. If the file system being checked is the root file system and 
modifications have been made, then either remount the root file sys- 
tem or reboot the system. A remount is done only if there was minor 
damage. 

If no file-systems are specified, fsck will read a list of default file systems 
from the file /etc/checklist. 

Inconsistencies checked are as follows: 

1. Blocks claimed by more than one inode or the free list. 

2. Blocks claimed by an inode or the free list outside the range 
of the file system. 

3. Incorrect link counts. 

4. Size checks: 

Incorrect number of blocks. 
Directory size not 16-byte aligned. 

5. Bad inode format. 

6. Blocks not accounted for anywhere. 

7. Directory checks: 

File pointing to unallocated inode. 
Inode number out of range. 

8. Super Block checks: 

More than 65536 inodes. 

More blocks for inodes than there are in the file sys- 
tem. 

9. Bad free block list format. 

10. Total free block and/or free inode count incorrect. 

Orphaned files and directories (allocated but unreferenced) are, with the 
user's concurrence, reconnected by placing them in the lost+found direc- 
tory, if the files are nonempty. The user will be notified if the file or direc- 
tory is empty or not. Empty files or directories are removed, as long as the 
-n option is not specified, fsck will force the reconnection of nonempty 
directories. The name assigned is the inode number. The only restriction is 
that the directory lost+found must preexist in the root of the file system 
being checked and must have empty slots in which entries can be made. 
This is accomplished by making lost+found, copying a number of files to 
the directory, and then removing them (before fsck is executed). 
Checking the raw device is almost always faster and should be used with 
everything but the root file system. 

dfsck 

The dfsck command allows two file system checks on two different drives 
simultaneously, optionsl and options! are used to pass options to fsck for 
the two sets of file systems. A - is the separator between the file system 
groups. 
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The dfsck command permits a user to interact with two fsck programs at 
once. To aid in this, dfsck will print the file system name for each message 
to the user. When answering a question from dfsck, the user must prefix the 
response with a 1 or a 2 (indicating that the answer refers to the first or 
second file system group). 

FILES 

/etc/checklist contains default list of file systems to check. 

SEE ALSO 

crash(lM), mkfs(lM), ncheck(lM), xfsck(lM). 

uadmin(2), checklist(4), fs(4) in the Programmer's Reference Manual. 

BUGS 

Inode numbers for . and . . in each directory are not checked for validity. 
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NAME 

fsdb - file system debugger 

SYNOPSIS 

/etc/fsdb special [ - ] 

DESCRIPTION 

The fsdb command can be used to patch up a damaged file system after a 
crash. It has conversions to translate block and i-numbers into their 
corresponding disk addresses. Also included are mnemonic offsets to access 
different parts of an inode. These greatly simplify the process of correcting 
control block entries or descending the file system tree. 

The fsdb command contains several error-checking routines to verify inode 
and block addresses. These can be disabled if necessary by invoking fsdb 
with the optional - argument or by the use of the O symbol, (fsdb reads 
the i-size and f-size entries from the super block of the file system as the 
basis for these checks.) 

Numbers are considered decimal by default. Octal numbers must be pre- 
fixed with a zero. During any assignment operation, numbers are checked 
for a possible truncation error due to a size mismatch between source and 
destination. 

The fsdb command reads a block at a time and will therefore work with raw 
as well as block I/O. A buffer management routine is used to retain com- 
monly used blocks of data in order to reduce the number of read system 
calls. All assignment operations result in an immediate write-through of the 
corresponding block. 

The symbols recognized by fsdb are: 



# 


absolute address 


i 


convert from i-number to inode address 


b 


convert to block address 


d 


directory slot offset 




address arithmetic 


q 


quit 


>,< 


save, restore an address 




numerical assignment 




incremental assignment 




decremental assignment 


= » 


character string assignment 


o 


error checking flip flop 


p 


general print facilities 


f 


file print facility 


B 


byte mode 


W 


word mode 


D 


double word mode 


1 


escape to shell 



The print facilities generate a formatted output in various styles. The 
current address is normalized to an appropriate boundary before printing 
begins. It advances with the printing and is left at the address of the last 
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item printed. The output can be terminated at any time by typing the 
delete character. If a number follows the p symbol, that many entries are 
printed. A check is made to detect block boundary overflows since logically 
sequential blocks are generally not physically sequential. If a count of zero 
is used, all entries to the end of the current block are printed. The print 
options available are: 



i print as inodes 

d print as directories 

o print as octal words 

e print as decimal words 

c print as characters 

b print as octal bytes 



The f symbol is used to print data blocks associated with the current inode. 
If followed by a number, that block of the file is printed. (Blocks are num- 
bered from zero.) The desired print option letter follows the block number, 
if present, or the f symbol. This print facility works for small as well as 
large files. It checks for special devices and checks that the block pointers 
used to find the data are not zero. 

Dots, tabs, and spaces may be used as function delimiters but are not neces- 
sary. A line with just a new-line character will increment the current 
address by the size of the data type last printed. That is, the address is set 
to the next byte, word, double word, directory entry, or inode, allowing the 
user to step through a region of a file system. Information is printed in a 
format appropriate to the data type. Bytes, words, and double words are 
displayed with the octal address followed by the value in octal and decimal. 
A .B or .D is appended to the address for byte and double word values, 
respectively. Directories are printed as a directory slot offset followed by 
the decimal i-number and the character representation of the entry name. 
Inodes are printed with labeled fields describing each element. 

The following mnemonics are used for inode examination and refer to the 
current working inode: 

md mode 

In link count 

uid user ID number 

gid group ID number 

sz file size 

a# data block numbers (0 - 12) 

at access time 

mt modification time 

maj major device number 

min minor device number 

EXAMPLES 

386i prints i-number 386 in an inode format. This now 

becomes the current working inode. 
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ln=4 changes the link count for the working inode to 4. 

ln=+l increments the link count by 1. 

fc prints, in ASCII, block zero of the file associated with the 

working inode. 

2i.fd prints the first 32 directory entries for the root inode of 

this file system. 

dSi.fc changes the current inode to that associated with the 5th 

directory entry (numbered from zero) found from the 
above command. The first logical block of the file is then 
printed in ASCII. 

512B.p0o prints the super block of this file system in octal. 

2i.a0b.d7=3 changes the i-number for the seventh directory slot in the 
root directory to 3. This example also shows how several 
operations can be combined on one command line. 

d7.nm="name" changes the name field in the directory slot to the given 
string. Quotes are optional when used with nm if the first 
character is alphabetic. 

a2b.p0d prints the third block of the current inode as directory 

entries. 

SEE ALSO 

fsck(lM). 

dir(4), fs(4) in the Programmer's Reference Manual. 
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NAME 

fsstat - report file system status 

SYNOPSIS 

/etc/fsstat special—file 

DESCRIPTION 

The fsstat command reports on the status of the file system on special— file . 
During startup, this command is used to determine if the file system needs 
checking before it is mounted. The fsstat command succeeds if the file sys- 
tem is unmounted and appears okay. For the root file system, it succeeds if 
the file system is active and not marked bad. 

SEE ALSO 

fs(4) in the Programmer's Reference Manual. 

DIAGNOSTICS 

The command has the following exit codes: 

the file system is not mounted and appears okay, (except for 
root where means mounted and okay). 

1 the file system is not mounted and needs to be checked. 

2 the file system is mounted. 

3 the command failed. 
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NAME 

fstyp - determine file system identifier 

SYNOPSIS 

fstyp special 

DESCRIPTION 

The fstyp command allows the user to determine the file system identifier of 
mounted or unmounted file systems using heuristic programs. The file sys- 
tem type is required by mount{2) and sometimes by mount{lM) to mount file 
systems of different types. 

The directory /etc/fstyp.d contains a program for each file system type to 
be checked; each of these programs applies some appropriate heuristic to 
determine whether the supplied special file is of the type for which it 
checks. If it is, the program prints on standard output the usual file-system 
identifier for that type and exits with a return code of 0; otherwise it prints 
error messages on standard error and exits with a non-zero return code. 
fstyp runs the programs in /etc/fstyp.d in alphabetical order, passing special 
as an argument; if any program succeeds, its file-system type identifier is 
printed and fstyp exits immediately. If no program succeeds, fstyp prints 
" Unknown_fstyp " to indicate failure. 

WARNING 

The use of heuristics implies that the result of fstyp is not guaranteed to be 
accurate. 

SEE ALSO 

mount(lM). 

mount(2), sysfs(2) in the Programmer's Reference Manual. 
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NAME 

fumount - forced unmount of an advertised resource 

SYNOPSIS 

fumount [-W sec] resource 

DESCRIPTION 

The fumount command unadvertises resource and disconnects remote access 
to the resource. The -w sec causes a delay of sec seconds prior to the exe- 
cution of the disconnect. 

When the forced unmount occurs, an administrative shell script is started on 
each remote computer that has the resource mounted (/usr/bin/rfuadmin). 
If a grace period of seconds is specified, rfuadmin is started with the fuwarn 
option. When the actual forced unmount is ready to occur, rfuadmin is 
started with the fumount option. See the rfuadmin{lM) manual page for 
information on the action taken in response to the forced unmount. 

This command is restricted to the super-user. 

ERRORS 

If resource (1) does not physically reside on the local machine, (2) is an 
invalid resource name, (3) is not currently advertised and is not remotely 
mounted, or (4) the command is not run with super-user privileges, an error 
message will be sent to standard error. 

SEE ALSO 

adv(lM), mount(lM), rfuadmin(lM), rfudaemon(lM), rmount(lM), 
unadv(lM). 
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NAME 

fusage - disk access profiler 
SYNOPSIS 

fusage [[mount_point] I [advertised_resource] I [block_special_device] [...]] 
DESCRIPTION 

When used with no options, fusage reports block i/o transfers, in kilobytes, 
to and from all locally mounted file systems and advertised Remote File 
Sharing resources on a per client basis. The count data are cumulative since 
the time of the mount. When used with an option, fusage reports on the 
named file system, advertised resource, or block special device. 

The report includes one section for each file system and advertised resource 
and has one entry for each machine that has the directory remotely 
mounted, ordered by decreasing usage. Sections are ordered by device 
name; advertised resources that are not complete file systems will immedi- 
ately follow the sections for the file systems they are in. 

SEE ALSO 

adv(lM), mount(lM), df(lM), crash(lM). 
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NAME 

fuser - identify processes using a file or file structure 
SYNOPSIS 

/etc/fuser [-ku] files I resources [-] [[-ku] files I resources] 
DESCRIPTION 

The fuser command outputs the process IDs of the processes that are using 
the files or remote resources specified as arguments. Each process ID is fol- 
lowed by a letter code, interpreted as follows: if the process is using the file 
as (1) its current directory, the code is c; (2) the parent of its current direc- 
tory (only when the file is being used by the system), the code is p; or (3) 
its root directory, the code is r. For block-special devices with mounted file 
systems, all processes using any file on that device are listed. For remote 
resource names, all processes using any file associated with that remote 
resource (Remote File Sharing) are reported, (fuser cannot use the mount 
point of the remote resource; it must use the resource name.) For all other 
types of files (text files, executables, directories, devices, etc.), only the 
processes using that file are reported. 

The following options may be used with fuser: 

-u the user login name, in parentheses, also follows the process ID. 

-k the SIGKILL signal is sent to each process. Since this option 
spawns kills for each process, the kill messages may not show up 
immediately [see kill (2)]. 

If more than one group of files are specified, the options may be respecified 
for each additional group of files. A lone dash cancels the options currently 
in force; then, the new set of options applies to the next group of files. 

The process IDs are printed as a single line on the standard output, 
separated by spaces and terminated with a single new line. All other output 
is written on standard error. 

You cannot list processes using a particular file from a remote resource 
mounted on your machine. You can only use the resource name as an 
argument. 

Any user with permission to read /dev/kmem and /dev/mem can use 
fuser. Only the super-user can terminate another user's process 

FILES 

/unix for system name list 

/dev/kmem for system image 
/dev/mem also for system image 

SEE ALSO 

mount(lM), ps(l). 

kill(2), signal(2) in the Programmer's Reference Manual. 
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NAME 

fwtmp, wtmpfix - manipulate connect accounting records 

SYNOPSIS 

/usr/lib/acct/fwtmp [-ic] 
/usr/lib/acct/ wtmpfix [files] 

DESCRIPTION 
fwtmp 

fwtmp reads from the standard input and writes to the standard output, con- 
verting binary records of the type found in wtmp to formatted ASCII 
records. The ASCII version is useful to enable editing, via ed(\), bad records 
or general purpose maintenance of the file. 

The argument -ic is used to denote that input is in ASCII form, and output 
is to be written in binary form. 

wtmpfix 

wtmpfix examines the standard input or named files in wtmp format, 
corrects the time/date stamps to make the entries consistent, and writes to 
the standard output. A - can be used in place of files to indicate the stan- 
dard input. If time/date corrections are not performed, acctcon{\M) will 
fault when it encounters certain date-change records. 

Each time the date is set, a pair of date change records are written to 
/etc/wtmp. The first record is the old date denoted by the string old time 
placed in the line field and the flag OLD_TIME placed in the type field of 
the <utmp.h> structure. The second record specifies the new date and is 
denoted by the string new time placed in the line field and the flag 
NEW-TIME placed in the type field, wtmpfix uses these records to syn- 
chronize all time stamps in the file. 

In addition to correcting time/date stamps, wtmpfix will check the validity 
of the name field to ensure that it consists solely of alphanumeric characters 
or spaces. If it encounters a name that is considered invalid, it will change 
the login name to INVALID and write a diagnostic to the standard error. In 
this way, wtmpfix reduces the chance that acctcon(\M) will fail when pro- 
cessing connect accounting records. 

FILES 

/etc/wtmp 
SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), 
acctsh(lM), ed(l), runacct(lM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference Manual 
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NAME 

getopt - parse command options 

SYNOPSIS 

set — 'getopt optstring $*' 

DESCRIPTION 

WARNING: Start using the new command getopts(l) in place of getopt {1). 
getopt (1) will not be supported in the next major release. For more infor- 
mation, see the WARNINGS section below. 

The getopt command is used to break up options in command lines for easy 
parsing by shell procedures and to check for legal options, optstring is a 
string of recognized option letters [see getopt{3C)]; if a letter is followed by a 
colon, the option is expected to have an argument which may or may not 
be separated from it by white space. The special option — is used to del- 
imit the end of the options. If it is used explicitly, getopt will recognize it; 
otherwise, getopt will generate it; in either case, getopt will place it at the 
end of the options. The positional parameters ($1 $2 ...) of the shell are 
reset so that each option is preceded by a - and is in its own positional 
parameter; each option argument is also parsed into its own positional 
parameter. 

EXAMPLE 

The following code fragment shows how one might process the arguments 
for a command that can take the options a or b, as well as the option o, 
which requires an argument: 

set — 'getopt abo : $*' 

if [ $? != ] 

then 

echo $USAGE 
exit 2 

f i 

for i in $* 
do 

case $i in 

-a I -b) FLAG=$i; shift;; 
-o) 0ARG = $2; shift 2;; 

— ) shift ; break ; ; 

esac 

done 

This code will accept any of the following as equivalent: 

cmd -aoarg file file 
cmd -a -o arg file file 
cmd -oarg -a file file 
cmd -a -oarg — file file 

SEE ALSO 

getopts(l), sh(l). 

getopt(3C) in the Programmer's Reference Manual. 
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DIAGNOSTICS ^ ^ , . 

The getopt command prints an error message on the standard error when it 
encounters an option letter not included in optstring, 

WARNINGS ^ . „ 1 o r 

The getopt (1) command does not support the part of Rule 8 of the com- 
mand syntax standard [see intro{l)] that permits groups of option-arguments 
following an option to be separated by white space and quoted. For exam- 
ple, 

cmd -a -b -o "xxx z yy" file 
is not handled correctly. To correct this deficiency, use the new command 
getopts(l) in place of getopt (1). 

getopt (1) will not be supported in the next major release. For this release, a 
conversion tool has been provided, getoptcvt . For more information about 
getopts and getoptcvt, see the getopts(l) manual page. 

If an option that takes an option-argument is followed by a value that is the 
same as one of the options listed in optstring (referring to the earlier EXAM- 
PLE section, but using the following command line: cmd -o -a file), getopt 
will always treat -a as an option-argument to -o; it will never recognize -a 
as an option. For this case, the for loop in the example will shift past the 
file argument. 
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NAME 

getopts, getoptcvt - parse command options 

SYNOPSIS 

getopts optstring name [arg ...] 

/usr/lib/getoptcvt [-b] file 

DESCRIPTION 

The getopts command is used by shell procedures to parse positional param- 
eters and to check for legal options. It supports all applicable rules of the 
command syntax standard [see Rules 3-10, intro(l)]. It should be used in 
place of the getopt{l) command. (See the WARNING below.) 

optstring must contain the option letters the command using getopts will 
recognize; if a letter is followed by a colon, the option is expected to have 
an argument, or group of arguments, which must be separated from it by 
white space. 

Each time it is invoked, getopts will place the next option in the shell vari- 
able name and the index of the next argument to be processed in the shell 
variable OPTIND. Whenever the shell or a shell procedure is invoked, 
OPTIND is initialized to 1. 

When an option requires an option-argument, getopts places it in the shell 
variable OPT ARG. 

If an illegal option is encountered, ? will be placed in name . 

When the end of options is encountered, getopts exits with a non-zero exit 
status. The special option may be used to delimit the end of the 

options. 

By default, getopts parses the positional parameters. If extra arguments (arg 
. . .) are given on the getopts command line, getopts will parse them instead. 
The /usr/lib/getoptcvt command reads the shell script in file, converts it to 
use getopts (1) instead of getopt{ll and writes the results on the standard 
output. 

-b the results of running /usr/lib/getoptcvt will be portable to earlier 
releases of the UNIX system, /usr/lib/getoptcvt modifies the shell 
script in file so that when the resulting shell script is executed, it 
determines at run time whether to invoke getopts{l) or getopt(l). 

So all new commands will adhere to the command syntax standard 
described in intro{l), they should use getopts (1) or getopt (SC) to parse posi- 
tional parameters and check for options that are legal for that command (see 
WARNINGS below). 
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EXAMPLE 

The following fragment of a shell program shows how one might process 
the arguments for a command that can take the options a or b, as well as 
the option o, which requires an option-argument: 

while getopts abo : c 
do 

case $c in 
a I b) FLAG=$c ; ; 

o) 0ARG=$0PTARG ; ; 

\?) echo $USAGE 

exit 2 ; ; 

esac 

done 

shift 'expr $OPTIND - V 

This code will accept any of the following as equivalent: 

cmd -a -b -o "xxx z yy" file 
cmd -a -b -o "xxx z yy" — file 
cmd — ab — o xxx,z,yy file 
cmd -ab -o "xxx z yy" file 
cmd — o xxx,z,yy — b —a file 

SEE ALSO 

intro(l), sh(l). 

getopt(3C) in the Programmer's Reference Manual . 
WARNING 

Although the following command syntax rule [see intro{l)] relaxations are 
permitted under the current implementation, they should not be used 
because they may not be supported in future releases of the system. As in 
the EXAMPLE section above, a and b are options, and the option o requires 
an option-argument: 

cmd -aboxxx file (Rule 5 violation: options with 

option-arguments must not be grouped with other options.) 
cmd -ab -oxxx file (Rule 6 violation: there must be 
white space after an option that takes an option-argument.) 

Changing the value of the shell variable OPTIND or parsing different sets of 
arguments may lead to unexpected results. 

DIAGNOSTICS 

getopts prints an error message on the standard error when it encounters an 
option letter not included in optstring. 
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NAME 

getty - set terminal type, modes, speed, and line discipline 
SYNOPSIS 

/etc/getty [ -h ] [ -t timeout ] line [ speed [ type [ linedisc ] ] ] 
/etc/getty -c file 

DESCRIPTION 

The getty command is a program that is invoked by init(lM). It is the 
second process in the series {init-getty'login-shell) that ultimately connects a 
user with the UNIX system. It can only be executed by the super-user; that 
is, a process with the user-ID of root. Initially, getty prints the login mes- 
sage field for the entry it is using from /etc/gettydefs. getty reads the 
user's login name and invokes the login (1) command with the user's name 
as the argument. While reading the name, getty attempts to adapt the sys- 
tem to the speed and type of terminal being used. It does this by using the 
options and arguments specified. 

Line is the name of a tty line in /dev to which getty is to attach itself, getty 
uses this string as the name of a file in the /dev directory to open for read- 
ing and writing. Unless getty is invoked with the -h flag, getty will force a 
hangup on the line by setting the speed to zero before setting the speed to 
the default or specified speed. The -t flag plus timeout (in seconds) specifies 
that getty should exit if the open on the line succeeds and no one types any- 
thing in the specified number of seconds. 

Speed, the optional second argument, is a label to a speed and tty definition 
in the file /etc/gettydefs. This definition tells getty at what speed to ini- 
tially run, what the login message should look like, what the initial tty set- 
tings are, and what speed to try next should the user indicate that the speed 
is inappropriate (by typing a <break> character). The default speed is 300 
baud. 

Type, the optional third argument, is a character string describing to getty 
what type of terminal is connected to the line in question, getty recognizes 
the following types: 

none default 

ds40-l DATASPEED terminal 40/1 

tektronix,tek TEKTRONIX 

vt61 Digital Equipment vt61 

vtlOO Digital Equipment vtlOO 

hp45 Hewlett-Packard 45 

clOO Concept 100 

The default terminal is none; i.e., any crt or normal terminal unknown to 
the system. Also, for terminal type to have any meaning, the virtual termi- 
nal handlers must be compiled into the operating system. They are avail- 
able, but not compiled in the default condition. 

Linedisc, the optional fourth argument, is a character string describing which 
line discipline to use in communicating with the terminal. Again, the hooks 
for line disciplines are available in the operating system, but there is only 
one presently available, the default line discipline LDISCO. 
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When given no optional arguments, getty sets the speed of the interface to 
300 baud, specifies that raw mode is to be used (awaken on every charac- 
ter), that echo is to be suppressed, either parity allowed, new-line characters 
will be converted to carriage return-line feed, and tab expansion performed 
on the standard output. It types the login message before reading the user's 
name a character at a time. If a null character (or framing error) is received, 
it is assumed to be the result of the user pushing the "break" key. This will 
cause getty to attempt the next speed in the series. The series that getty tries 
is determined by what it finds in /etc/gettydefs. 

After the user's name has been typed in, it is terminated by a new-line or 
carriage-return character. The latter results in the system being set to treat 
carriage returns appropriately [see ioctl(2)]. 

The user's name is scanned to see if it contains any lower case alphabetic 
characters; if not, and if the name is non-empty, the system is told to map 
any future upper case characters into the corresponding lower case charac- 
ters. 

Finally, login is exec'd with the user's name as an argument. Additional 
arguments may be typed after the login name. These are passed to login, 
which will place them in the environment [see login{l)]. 
A check option is provided. When getty is invoked with the -c option and 
file it scans the file as if it were scanning /etc/gettydefs and prints out the 
results to the standard output. If there are any unrecognized modes or 
improperly constructed entries, it reports these. If the entries are correct it 
prints out the values of the various flags. See ioctl(2) to interpret the 
values. Note that some values are added to the flags automatically. 

/etc/gettydefs 
SEE ALSO 

ct(lC), init(lM), login(l), uugetty(lM), tty(7). 

ioctl(2), gettydefs(4), inittab(4) in the Programmer's Reference Manual. 

BUGS 

While getty understands simple single character quoting conventions, it is 
not possible to quote certain special control characters used by getty. Jhus, 
you cannot log in via getty and type a #, @, /, I backspace, U, D, or 
& as part of your login name or arguments, getty uses them to determine 
when the end of the line has been reached, which protocol is being used, 
and what the erase character is. They will always be interpreted as having 
their special meaning. 

WARNING , 
When connecting two computers using a direct connection, never invoke 
getty(lU) on the ports of both machines. Instead, use uugetty(lU). 
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NAME 

graph - draw a graph 

SYNOPSIS 

graph [ options ] 

DESCRIPTION 

The graph command with no options takes pairs of numbers from the stan- 
dard input as abscissas and ordinates of a graph. Successive points are con- 
nected by straight lines. The graph is encoded on the standard output for 
display by the tplot{lG) filters. 

If the coordinates of a point are followed by a non-numeric string, that 
string is printed as a label beginning on the point. Labels may be sur- 
rounded with quotes in which case they may be empty or contain blanks 
and numbers; labels never contain new-lines. 

The following options are recognized, each as a separate argument: 

-a Supply abscissas automatically (they are missing from the input); 

spacing is given by the next argument (default 1). A second 

optional argument is the starting point for automatic abscissas 

(default or lower limit given by -x). 
-b Break (disconnect) the graph after each label in the input, 

-c Character string given by next argument is default label for each 

point. 

-g Next argument is grid style, no grid, 1 frame with ticks, 2 full 

grid (default). 
-1 Next argument is label for graph. 

-m Next argument is mode (style) of connecting lines: discon- 

nected, 1 connected (default). Some devices give distinguishable 
line styles for other small integers (e.g., the Tektronix 4014: 
2=dotted, 3=dash-dot, 4=short-dash, 5=long-dash). 

-s Save screen, do not erase before plotting. 

-X [ 1 ] If 1 is present, x axis is logarithmic. Next 1 (or 2) arguments are 
lower (and upper) x limits. Third argument, if present, is grid 
spacing on x axis. Normally these quantities are determined 
automatically. 

-y [ 1 ] Similarly for y. 

-h Next argument is fraction of space for height, 

-w Similarly for width. 

-r Next argument is fraction of space to move right before plotting, 

-u Similarly to move up before plotting. 

-t Transpose horizontal and vertical axes. (Option -x now applies 

to the vertical axis.) 
A legend indicating grid range is produced with a grid unless the -s option 
is present. If a specified lower limit exceeds the upper limit, the axis is 
reversed. 

SEE ALSO 

graphics(lG), spline(lG), tplot(lG). 
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The graph command stores all points internally and drops those for which 
there is no room. 

Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 
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NAME 

greek - select terminal filter 

SYNOPSIS 

greek [ -Tterminal ] 

DESCRIPTION 

greek is a filter that reinterprets the extended character set, as well as the 
reverse and half-line motions, of a 128-character TELETYPE Model 37 ter- 
minal for certain other terminals. Special characters are simulated by over- 
striking, if necessary and possible. If the argument is omitted, greek 
attempts to use the environment variable $TERM [see environ{5)]. Currently, 
the following terminals are recognized: 

300 DASI 300. 

300-12 DASI 300 in 12-pitch. 

300s DASI 300s. 

300S-12 DASI 300s in 12-pitch. 

450 DASI 450. 

450-12 DASI 450 in 12-pitch. 

1620 Diablo 1620 (alias DASI 450). 

1620-12 Diablo 1620 (alias DASI 450) in 12-pitch. 

2621 Hewlett-Packard 2621, 2640, and 2645. 

2640 Hewlett-Packard 2621, 2640, and 2645. 

2645 Hewlett-Packard 2621, 2640, and 2645. 

4014 Tektronix 4014. 

hp Hewlett-Packard 2621, 2640, and 2645. 

tek Tektronix 4014. 

FILES 

/usr/bin/300 

/usr/bin/300s 

/usr/bin/4014 

/usr/bin/450 

/usr/bin/hp 

SEE ALSO 

300(1), 4014(1), 450(1), hp(l), tplot(lG). 

environ(5), term(5) in the Programmer's Reference Manual. 
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NAME 

grep - search a file for a pattern 
SYNOPSIS 

grep [options] limited regular expression [file ...] 
DESCRIPTION 

The grep command searches files for a pattern and prints all lines that con- 
tain that pattern. The grep command uses limited regular expressions 
(expressions that have string values that use a subset of the possible 
alphanumeric and special characters) like those used with ed(l) to match the 
patterns. It uses a compact non-deterministic algorithm. 

Be careful using the characters $, *, [, ^ |, (, ), and \ in the limited regular 
expression because they are also meaningful to the shell. It is safest to 
enclose the entire limited regular expression in single quotes 

If no files are specified, grep assumes standard input. Normally, each line 
found is copied to standard output. The file name is printed before each 
line found if there is more than one input file. 
Command line options are: 

-b Precede each line by the block number on which it was found. This 
can be useful in locating block numbers by context (first block is 0). 

-c Print only a count of the lines that contain the pattern. 

-i Ignore upper/lower case distinction during comparisons. 

-h Prevents the name of the file containing the matching line from being 
appended to that line. Used when searching multiple files. 

-1 Print the names of files with matching lines once, separated by new- 
lines. Does not repeat the names of files when the pattern is found 
more than once. 

-n Precede each line by its line number in the file (first line is 1). 
-s Suppress error messages about nonexistent or unreadable files. 
-V Print all lines except those that contain the pattern. 

SEE ALSO 

ed(l), egrep(l), fgrep(l), sed(l), sh(l). 

DIAGNOSTICS 

Exit status is if any matches are found, 1 if none, 2 for syntax errors or 
inaccessible files (even if matches were found). 

BUGS 

Lines are limited to BUFSIZ characters; longer lines are truncated. BUFSIZ is 
defined in /usr/include/stdio.h, which is included as part of the basic 
software development set. 

If there is a line with embedded nulls, grep will only match up to the first 
null; if it matches, it will print the entire line. 
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NAME 

hd - display files in hexadecimal format 
SYNOPSIS 

hd [ -format [ -s offset ] [ -n count ] [ file ] ... 
DESCRIPTION 

The hd command displays the contents of files in hexadecimal, octal, 
decimal, and character formats. Control over the specification of ranges of 
characters is also available. The default behavior is v^ith the following flags 
set: -abx -A. This says that addresses (file offsets) and bytes are printed in 
hexadecimal and that characters are also printed. If no file argument is 
given, the standard input is read. 

Options include: 

-s offset Specify the beginning offset in the file where printing is to 
begin. If no file argument is given or if a seek fails because 
the input is a pipe, offset bytes are read from the input and dis- 
carded. Otherwise, a seek error will terminate processing of 
the current file. 

The offset may be given in decimal, hexadecimal (preceded by 
Ox), or octal (preceded by a 0). It is optionally followed by one 
of the following multipliers: w, 1, b, or k; for words (2 bytes), 
long words (4 bytes), blocks (512 bytes), or K bytes (1024 
bytes). Note that this is the one case where b does not stand 
for bytes. Since specifying a hexadecimal offset in blocks 
would result in an ambiguous trailing b, any offset and multi- 
plier may be separated by an asterisk (*). 

-n count Specify the number of bytes to process. The count is in the 
same format as offset above. 

FORMAT FLAGS 

Format flags may specify addresses, characters, bytes, words (2 bytes), or 
longs (4 bytes) to be printed in hexadecimal, decimal, or octal. Two special 
formats may also be indicated: text or ASCII. Format and base specifiers 
may be freely combined and repeated as desired to specify different bases 
(hexadecimal, decimal, or octal) for different output formats (addresses, 
characters, etc.). All format flags appearing in a single argument are applied 
as appropriate to all other flags in that argument. 

acbwlA 

Output format specifiers for addresses, characters, bytes, words, 
longs, and ASCII, respectively. Only one base specifier will be used 
for addresses; the address will appear on the first line of output that 
begins each new offset in the input. 

The character format prints printable characters unchanged special C 
escapes as defined in the language, and remaining values in the 
specified base. 

The ASCII format prints all printable characters unchanged, and all 
others as a period (.). This format appears to the right of the first of 
other specified output formats. A base specifier has no meaning 
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with the ASCII format. If no other output format (other than 
addresses) is given, bx is assumed. If no base specifier is given, all 
of xdo are used. 

xdo Output base specifiers for hexadecimal, decimal, and octal. If no 
format specifier is given, all of acbwl are used. 

t Print a text file, each line preceded by the address in the file. Nor- 

mally, lines should be terminated by a \n character, but long lines 
will be broken up. Control characters in the range 0x00 to 0x1 f are 
printed as ' @' to ' Bytes with the high bit set are preceded by 
a tilde (") and printed as if the high bit were not set. The special 
characters ( , \) are preceded by a backslash (\) to escape their 
special meaning. As special cases, two values are represented 
numerically as \177' and \377'. This flag will override all output 
format specifiers except addresses. 
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NAME 

hp - handle special functions of Hewlett-Packard terminals 

SYNOPSIS 

hp [ -e ] [ -m ] 

DESCRIPTION 

hp supports special functions of the Hewlett-Packard 2640 series of termi- 
nals, with the primary purpose of producing accurate representations of 
most nroff output. A typical usage is in conjunction with DOCUMENTER'S 
WORKBENCH Software: 

nroff -h files ... | hp 

Regardless of the hardware options on your terminal, hp tries to do sensible 
things with underlining and reverse line-feeds. If the terminal has the 
"display enhancements" feature, subscripts and superscripts can be indi- 
cated in distinct ways. If it has the "mathematical-symbol" feature, Greek 
and other special characters can be displayed. 

The flags are as follows: 

-e It is assumed that your terminal has the "display enhancements" 
feature, and so maximal use is made of the added display modes. 
Overstruck characters are presented in the Underlined mode. 
Superscripts are shown in Half-bright mode, and subscripts in Half- 
bright, Underlined mode. If this flag is omitted, hp assumes that 
your terminal lacks the "display enhancements" feature. In this 
case, all overstruck characters, subscripts, and superscripts are 
displayed in Inverse Video mode, i.e., dark-on-light, rather than the 
usual light-on-dark. 

-m Requests minimization of output by removal of new-lines. Any 
contiguous sequence of 3 or more new-lines is converted into a 
sequence of only 2 new-lines; i.e., any number of successive blank 
lines produces only a single blank output line. This allows you to 
retain more actual text on the screen. 

With regard to Greek and other special characters, hp provides the same set 
as does 300(1), except that "not" is approximated by a right arrow, and 
only the top half of the integral sign is shown. 

DIAGNOSTICS 

line too long if the representation of a line exceeds 1,024 characters. 
The exit codes are for normal termination, 2 for all errors. 

SEE ALSO 

300(1), greek(l). 

BUGS 

An " overstriking sequence" is defined as a printing character followed by a 
backspace followed by another printing character. In such sequences, if 
either printing character is an underscore, the other printing character is 
shown underlined or in Inverse Video; otherwise, only the first printing 
character is shown (again, underlined or in Inverse Video). Nothing special 
is done if a backspace is adjacent to an ASCII control character. Sequences 
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of control characters (e.g., reverse line-feeds, backspaces) can make text 
"disappear"; in particular, tables generated by tbl{l) that contain vertical 
lines will often be missing the lines of text that contain the "foot" of a vert- 
ical line, unless the input to hp is piped through co/(l). 
Although some terminals do provide numerical superscript characters, no 
attempt is made to display them. 
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NAME 

id - print user and group IDs and names 

SYNOPSIS 
id 

DESCRIPTION 

The id command outputs the user and group IDs and the corresponding 
names of the invoking process. If the effective and real IDs are different, 
both are printed. 

SEE ALSO 

logname(l). 

getuid(2) in the Programmer's Reference Manual. 
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NAME 

idbuild - build new UNIX system kernel 

SYNOPSIS 

/etc /conf /bin /idbuild 

DESCRIPTION 

This script builds a new UNIX system kernel using the current system confi- 
guration in etc/conf/. Kernel reconfigurations are usually done after a dev- 
ice driver is installed, or system tunable parameters are modified. The script 
uses the shell variable $ROOT from the user's environment as its starting 
path. Except for the special case of kernel development in a non-root 
source tree, the shell variable ROOT should always be set to null or to 
" / " . idbuild exits with a return code of zero on success and non-zero on 
failure. 

Building a new UNIX system image consists of generating new system con- 
figuration files, then link-editing the kernel and device driver object 
modules in the etc/conf/pack.d object tree. This is done by idbuild by cal- 
ling the following commands: 

etc/conf /bin/ idconfig To build kernel configuration files. 

etc/conf /bin/ idmkunix To process the configuration files and link-edit a 
new UNIX system image. 

The system configuration files are built by processing the Master and Sys- 
tem files representing device driver and tunable parameter specifications. 
For the 1386 UNIX system the files etc/conf/cf.d/mdevice, and 
etc/conf /cf.d/mtune represent the Master information. The file 
etc/conf/cf.d/stune, and the files specified in etc/conf /sdevice.d/* 
represent the System information. The kernel also has file system type 
information defined in the files specified by etc/conf/sfsys.d/* and 
etc /conf /mf sys.d/*. 

Once a new UNIX system kernel has been configured, a lock file is set in 
etc/.new_-unix which causes the new kernel to replace /unix on the next 
system shutdown (i.e., on the next entry to the init state). Upon the next 
system boot, the new kernel will be executed. 

ERROR MESSAGES 

Since idbuild calls other system commands to accomplish system reconfi- 
guration and link editing, it will report all errors encountered by those com- 
mands, then clean up intermediate files created in the process. In general, 
the exit value 1 indicates an error was encountered by idbuild. 

The errors encountered fall into the following categories: 

Master file error messages. 

System file error messages. 

Tunable file error messages. 

Compiler and Link-editor error messages. 

All error messages are designed to be self-explanatory. 
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SEE ALSO 

idinstall(lm), idtune(lm). 

mdevice(4), mfsys(4), mtune(4), sdevice(4), sfsys(4), stune(4) in the 
Programmer's Reference Manual. 
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NAME 

idcheck - returns selected information 

SYNOPSIS 

/etc /conf /bin /idcheck 

DESCRIPTION 

This command returns selected information about the system configuration. 
It is useful in add-on device Driver Software Package (DSP) installation 
scripts to determine if a particular device driver has already been installed, 
or to verify that a particular interrupt vector, I/O address or other selectable 
parameter is in fact available for use. The various forms are: 

idcheck -p device-name [-i dir] [-r] 

idcheck -v vector [-i dir] [-r] 

idcheck -d dma-channel [-i dir] [-r] 

idcheck -a -1 lower_address -u upper_address [-i dir] [-r] 
idcheck -c -1 lower_address -u upper_address [-i dir] [-r] 

This command scans the System and Master modules and returns: 
100 if an error occurs. 
if no conflict exists. 

a positive number greater than and less than 100 if a conflict 
exists. 

The command line options are: 

-r Report device name of any conflicting device on stdout. 

-p device-name This option checks for the existence of four different com- 
ponents of the DSP. The exit code is the addition of the 
return codes from the four checks. 

Add 1 to the exit code if the DSP directory under 
/etc/conf/pack.d exists. 

Add 2 to the exit code if the Master module has been 
installed. 

Add 4 to the exit code if the System module has been 
installed. 

Add 8 to the exit code if the Kernel was built with the 
System module. 

Add 16 to the exit code if a Driver.o is part of the DSP 
(vs. a stubs.c file). 

-V vector Returns 'type' field of device that is using the vector 

specified (i.e., another DSP is already using the vector). 

-d dma-channel Returns 1 if the dma channel specified is being used, 
-a This option checks whether the lOA region bounded by 

"lower" and "upper" conflict with another DSP 
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("lower" and "upper" are specified with the -1 and -u 
options). The exit code is the addition of two different 
return codes. 

Add 1 to the exit code if the lOA region overlaps with 
another device. 

Add 2 to the exit code if the lOA region overlaps with 
another device and that device has the 'O' option speci- 
fied in the type field of the Master module. The 'O' 
option permits a driver to overlap the lOA region of 
another driver. 

-c Returns 1 if the CM A region bounded by "lower" and 

"upper" conflict with another DSP ("lower" and 
"upper" are specified with the -1 and -u options). 

-1 address Lower bound of address range specified in hex. The lead- 

ing Ox is unnecessary. 

-u address Upper bound of address range specified in hex. The lead- 

ing Ox is unnecessary. 

-i dir Specifies the directory in which the ID files sdevice and 

mdevice reside. The default directory is /etc/conf/cf.d. 

ERROR MESSAGES 

There are no error messages or checks for valid arguments to options. 
idcheck interprets these arguments using the rules of scanf{3) and queries the 
sdevice and mdevice files. For example, if a letter is used in the place of a 
digit, scanf(3) will translate the letter to 0. idcheck will then use this value 
in its query. 

SEE ALSO 

idinstall(lm). 

mdevice(4), sdevice(4) in the Programmer's Reference Manual. 
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NAME 

idinstall - add, delete, update, or get device driver configuration data 
SYNOPSIS 

/etc/conf/bin/idinstall -[adug] [-e] -[ msoptnirhcl ] dev_name 
DESCRIPTION 

The idinstall command is called by a Driver Software Package (DSP) Install 
script or Remove script to Add (-a). Delete (-d). Update (-u), or Get (-g) 
device driver configuration data, idinstall expects to find driver component 
files in the current directory. When components are installed or updated, 
they are moved or appended to files in the /etc/conf directory and then 
deleted from the current directory unless the -k flag is used. The options 
for the command are as follows: 
Action Specifiers: 

-a Add the DSP components 
-d Remove the DSP components 
-u Update the DSP components 

-g Get the DSP components (print to std out, except Master) 
Component Specifiers: (*) 

-m Master component 

-s System component 

-o Driver.o component 

-p Space. c component 

-t Stubs. c component 

-n Node (special file) component 

-i Inittab component 

-r Device Initialization (rc) component 

-h Device shutdown (sd) component 

-c Mfsys component: file system type config (Master) data 

-1 Sfsys component: file system type local (System) data 

(*) If no component is specified, the default is all except for the -g 
option where a single component must be specified explicitly. 

Miscellaneous: 

-e Disable free disk space check 

-k Keep files (do not remove from current directory) on add or 
update. 

In the simplest case of installing a new DSP, the command syntax used by 
the DSP's Install script should be idinstall -a dev^name. In this case the 
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command will require and install a Driver.o, Master and System entry, and 
optionally install the Space.c, Stubs.c, Node, Init, Rc, Shutdown, Mfsys, and 
Sfsys components if those modules are present in the current directory. 
The Driver.o, Space.c, and Stubs.c files are moved to a directory in 
/etc/conf/pack.d. The dev-tiame is passed as an argument, which is used 
as the directory name. The remaining components are stored in the 
corresponding directories under /etc/conf in a file whose name is 
dev_name. For example, the Node file would be moved to 
/etc/conf/node.d/dev_jiame. 

The idinstall -m usage provides an interface to the idmaster command which 
will add, delete, and update mdevice file entries using a Master file from the 
local directory. An interface is provided here so that driver writers have a 
consistent interface to install any DSP component. 

As stated above, driver writers will generally use only the idinstall -a 
dev-name form of the command. Other options of idinstall are provided to 
allow an Update DSP (i.e., one that replaces an existing device driver com- 
ponent) to be installed, and to support installation of multiple controller 
boards of the same type. 

If the call to idinstall uses the -u (update) option, it will: 

overlay the files of the old DSP with the files of the new DSP. 

invoke the idmaster command with the 'update' option if a Master 
module is part of the new DSP. 

idinstall also does a verification that enough free disk space is available to 
start the reconfiguration process. This is done by calling the idspace com- 
mand, idinstall will fail if insufficient space exists, and exit with a non-zero 
return code. The -e option bypasses this check. 

idinstall makes a record of the last device installed in a file 
(/etc/.last_dev_add), and saves all removed files from the last delete 
operation in a directory (/etc/.last_dev_del). These files are recovered by 
/etc/conf /bin /idmkenv whenever it is determined that a system reconfigura- 
tion was aborted due to a power failure or unexpected system reboot. 
ERROR MESSAGES 

An exit value of zero indicates success. If an error was encountered, idin- 
stall will exit with a non-zero value, and report an error message. All error 
messages are designed to be self-explanatory. Typical error message that 
can be generated by idinstall are as follows: 

Device package already exists. 

Cannot make the driver package directory. 

Cannot remove driver package directory. 

Local directory does not contain a Driver object (Driver.o) file. 

Local directory does not contain a Master file. 

Local directory does not contain a System file. 

Cannot remove driver entry. 
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SEE ALSO 

idspace(lm), idcheck(lm). 

mdevice(4), sdevice(4) in the Programmer's Reference Manual. 
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NAME 

idload - Remote File Sharing user and group mapping 
SYNOPSIS 

idload [-n] [-g g_rules] [-u u_rules] [directory] 
idload -k 

DESCRIPTION 

idload is used on Remote File Sharing server machines to build translation 
tables for user and group ids. It takes your /etc/passwd and /etc/group 
files and produces translation tables for user and group ids from remote 
machines, according to the rules set down in the u^rules and rules files. 
If you are mapping by user and group name, you will need copies of remote 
/etc/passwd and /etc/group files. If no rules files are specified, remote 
user and group ids are mapped to MAXUID+1 (this is an id number that is 
one higher than the highest number you could assign on your system.) 

By default, the remote password and group files are assumed to reside in 
/usT/nserye/sLVLthAn{o/domain/nodename/[p!LSsvrd\ group]. The directory 
argument indicates that some directory structure other than 
/usr/nserve/auth.info contains the domain /nodename passwd and group 
files, {nodename is the name of the computer the files are from and domain 
is the domain where that computer is a member.) 

You must run idload to put the mapping into place. Global mapping will 
take effect immediately for machines that have one of your resources 
currently mounted. Mapping for other specific machines will take effect 
when each machine mounts one of your resources. 

-n This is used to do a trial run of the id mapping. No transla- 

tion table will be produced; however, a display of the mapping 
is output to the terminal (stdout). 

-k This is used to print the id mapping that is currently in use. 

(Specific mapping for remote machines will not be shown until 
that machine mounts one of your resources.) 

-u u— rules The U— rules file contains the rules for user id translation. The 
default rules file is /usr/nserve/auth.info/uid.rules. 

-gg— rules The g-.rules file contains the rules for group id translation. 

The default rules file is /usr/nserve/auth.info/gid.rules. 
This command is restricted to the super-user. 

Rules 

The rules files have two types of sections (both optional): global and host. 
There can be only one global section, though there can be one host section 
for each computer you want to map. 

The global section describes the default conditions for translation for any 
machines that are not explicitly referenced in a host section. If the global 
section is missing, the default action is to map all remote user and group ids 
from undefined computers to MAXUID-f-1. The syntax of the first line of 
the global section is: 



- 1 - 



IDLOAD(IM) 



(Remote File Sharing Utilities) 



IDLOAD(IM) 



global 

A host section is used for each machine or group of machines that you 
want to map differently from the global definitions. The syntax of the first 
line of each host section is: 

host name ... 

where name is replaced by the full name of a computer (domain. no dename). 

The format of a rules file is described below. (All lines are optional, but 
must appear in the order shown.) 

global 

default local I transparent 

exclude remote— id-remote—id I remote— id 

map remote— idilocal 

host domain.nodename [domain.nodename...] 
default local I transparent 

exclude remote— id-remote— id I remote— id I remote— name 
map remotedocal I remote I all 

Each of these instruction types is described below. 

The line 

default local I transparent 

defines the mode of mapping for remote users that are not specifically 
mapped in instructions in other lines, transparent means that each remote 
user and group id will have the same numeric value locally unless it 
appears in the exclude instruction, local can be replaced by a local user 
name or id to map all users into a particular local name or id number. If 
the default line is omitted, all users that are not specifically mapped are 
mapped into a "special guest" login id. 

The line 

exclude remote— id-remote— id I remote— id I remote— name 

defines remote ids that will be excluded from the default mapping. The 
exclude instruction must precede any map instructions in a block. You can 
use a range of id numbers, a single id number, or a single name. 
{remote— name cannot be used in a global block.) 

The line 

map remotedocal I remote I all 

defines the local ids and names that remote ids and names will be mapped 
into, remote is either a remote id number or remote name; local is either a 
local id number or local name. Placing a colon between a remote and a local 
will give the value on the left the permissions of the value on the right. A 
single remote name or id will assign the user or group permissions of the 
same local name or id. all is a predefined alias for the set of all user and 
group ids found in the local /etc/passwd and /etc/group files. (You can- 
not map by remote name in global blocks.) 



- 2 - 



IDLOAD(IM) 



(Remote File Sharing Utilities) 



IDLOAD(IM) 



NOTE: idload will always output warning messages for map all, since pass- 
word files always contain multiple administrative user names with the same 
id number. The first mapping attempt on the id number will succeed; each 
subsequent attempt will produce a warning. 

Remote File Sharing doesn't need to be running to use idload, 

EXIT STATUS 

On successful completion, idload will produce one or more translation tables 
and return a successful exit status. If idload fails, the command will return 
an exit status of zero and not produce a translation table. 

ERRORS 

If (1) either rules file cannot be found or opened; (2) there are syntax errors 
in the rules file; (3) there are semantic errors in the rules file; (4) host pass- 
word or group information could not be found; or (5) the command is not 
run with super-user privileges, an error message will be sent to standard 
error. Partial failures will cause a warning message to appear, though the 
process will continue. 

FILES 

/etc/passwd 
/etc/group 

/usr/nserve/auth.info/ domain /nodename /[user \ group] 
/usr/nserve /auth.info /uid.rules 
/usr/nserve/auth.info/gid.rules 

SEE ALSO 

mount(lM). 

"Remote File Sharing" chapter of the User's /System Administrator's Guide 
for detailed information on ID mapping. 
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NAME 

idmkinit - read files containing specifications 

SYNOPSIS 

/etc/conf/bin/idmkinit 

DESCRIPTION 

This command reads the files containing specifications of /etc/inittab 
entries from /etc/conf/init.d and constructs a new inittab file in 
/etc/conf/cf.d. It returns on success and a positive number on error. 

The files in /etc/conf/init.d are copies of the Init modules in device Driver 
Software Packages (DSP). There is at most one Init file per DSP. Each file 
contains one line for each inittab entry to be installed. There may be mul- 
tiple lines (i.e., multiple inittab entries) per file. An inittab entry has the 
form (the id field is often called the tag): 

id:rstate:action:process 

The Init module entry must have one of the following forms: 
action-.process 
rstate:action:process 
id:rstate:action:process 

When idmkinit encounters an entry of the first type, a valid id field will be 
generated, and an rstate field of 2 (indicating run on init state 2) will be 
generated. When an entry of the second type is encountered, only the id 
field is prefixed. An entry of the third type is incorporated into the new 
inittab unchanged. 

Since add-on inittab entries specify init state 2 for their rstate field most 
often, an entry of the first type should almost always be used. An entry of 
the second type may be specified if you need to specify other than state 2. 
DSP's should avoid specifying the id field as in the third entry since other 
add-on applications or DSPs may have already used the id value you have 
chosen. The /etc/init program will encounter serious errors if one or more 
inittab entries contain the same id field. 

Idmkinit determines which of the three forms above is being used for the 
entry by requiring each entry to have a valid action keyword. Valid action 
values are as follows: 

off 

respawn 

ondemand 

once 

wait 

boot 

bootwait 

powerfail 

powerwait 

initdefault 

sysinit 
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The idmkinit command is called automatically upon entering init state 2 on 
the next system reboot after a kernel reconfiguration to establish the correct 
/etc/inittab for the running /unix kernel, idmkinit can be called as a user 
level command to test modification of inittab before a DSP is actually built. 
It is also useful in installation scripts that do not reconfigure the kernel but 
need to create inittab entries. In this case, the inittab generated by idmk- 
init must be copied to /etc/inittab, and a telinit q command must be run to 
make the new entry take effect. 

The command line options are 

-o directory inittab will be created in the directory specified rather than 
/etc/conf/cf.d. 

-i directory The ID file init.base, which normally resides in 
/etc/conf/cf.d, can be found in the directory specified. 

-e directory The Init modules that are usually in /etc/conf/init.d can be 
found in the directory specified. 

-# Print debugging information. 

ERROR MESSAGES 

An exit value of zero indicates success. If an error was encountered, idmk- 
init will exit with a non-zero value and report an error message. All error 
messages are designed to be self-explanatory. 

SEE ALSO 

idbuild(l), idinstall(lm), idmknod(lm), init(lm). 
inittab(4) in the Programmer's Reference Manual. 
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NAME 

idmknod - removes nodes and reads specifications of nodes 

SYNOPSIS 

/etc/conf/bin/idmknod 

DESCRIPTION 

This command performs the following functions: 

Removes the nodes for non-required devices (those that do not have 
an 'r' in field 3 of the the device's mdevice entry) from /dev. Ordi- 
nary files will not be removed. If the /dev directory contains sub- 
directories, those subdirectories will be transversed and nodes found 
for non-required devices will be removed as well. If empty sub- 
directories result due to the removal of nodes, the subdirectories are 
then removed. 

Reads the specifications of nodes given in the files contained in 
/etc/conf/node.d and installs these nodes in /dev. If the node 
specification defines a path containing subdirectories, the subdirec- 
tories will be made automatically. 
Returns on success and a positive number on error. 

The idmknod command is run automatically upon entering init state 2 on the 
next system reboot after a kernel reconfiguration to establish the correct 
representation of device nodes in the /dev directory for the running /unix 
kernel, idmknod can be called as a user level command to test modification 
of the /dev directory before a DSP is actually built. It is also useful in ins- 
tallation scripts that do not reconfigure the kernel, but need to create /dev 
entries. 

The files in /etc/conf/node.d are copies of the Node modules installed by 
device Driver Software Packages (DSP). There is at most one file per DSP. 
Each file contains one line for each node that is to be installed. The format 
of each line is: 

Name of device entry (field 1) in the mdevice file (The mdevice entry 
will be the line installed by the DSP from its Master module). This 
field must be from 1 to 8 characters in length. The first character 
must be a letter. The others may be letters, digits, or underscores. 

Name of node to be inserted in /dev. The first character must be a 
letter. The others may be letters, digits, or underscores. This field 
can be a path relative to /dev, and idmknod will create subdirec- 
tories as needed. 

The character b or c. A b indicates that the node is a 'block' type 
device and c indicates 'character' type device. 

Minor device number. This value must be between and 255. If 
this field is a non-numeric, it is assumed to be a request for a 
streams clone device node, and idmknod will set the minor number 
to the value of the major number of the device specified. 
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Some example node file entries are as follows: 

asy ttyOO c 1 

makes /dev/ttyOO for device 'asy' using minor device 1. 

qt rmt/cOsO c 4 

makes /dev/rmt/cOsO for device 'qt' using minor device 4. 

clone net/nau/clone c nau 

makes /dev/net/nau/clone for device 'clone'. The minor device 
number is set to the major device number of device 'nau'. 

The command line options are: 

-o directory Nodes v^ill be installed in the directory specified rather than 
/dev. 

-i directory The file mdevice which normally resides in /etc/conf/cf.d, 
can be found in the directory specified. 

-e directory The Node modules that normally reside in /etc/conf/node.d 
can be found in the directory specified. 

-s Suppress removing nodes (just add new nodes). 

ERROR MESSAGES 

An exit value of zero indicates success. If an error was encountered due to 
a syntax or format error in a node entry, an advisory message will be printed 
to stdout and the command will continue. If a serious error is encountered 
(i.e., a required file cannot be found), idmknod will exit with a non-zero 
value and report an error message. All error messages are designed to be 
self-explanatory. 

SEE ALSO 

idinstall(lm), idmkinit(lm). 

mdevice(4), sdevice(4) in the Programmer's Reference Manual. 
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NAME 

idspace - investigates free space 
SYNOPSIS 

/etc/conf/bin/idspace [ -i inodes ] [ -r blocks ] [ -u blocks ] 
[ -t blocks ] 

DESCRIPTION 

This command investigates free space in /, /usr, and /tmp file systems to 
determine whether sufficient disk blocks and inodes exist in each of poten- 
tially 3 file systems. The default tests that idspace performs are as follows: 

Verify that the root file system (/) has 400 blocks more than the 
size of the current /unix. This verifies that a device driver being 
added to the current /unix can be built and placed in the root direc- 
tory. A check is also made to insure that 100 inodes exist in the 
root directory. 

Determine whether a /usr file system exists. If it does exist, a test 
is made that 400 free blocks and 100 inodes are available in that file 
system. If the file system does not exist, idspace does not complain 
since files created in /usr by the reconfiguration process will be 
created in the root file system and space requirements are covered 
by the test in (1.) above. 

Determine whether a /tmp file system exists. If it does exist, a test 
is made that 400 free blocks and 100 inodes are available in that file 
system. If the file system does not exist, idspace does not complain 
since files created in /tmp by the reconfiguration process will be 
created in the root file system and space requirements are covered 
by the test in (1.) above. 

The command line options are: 

-i inodes This option overrides the default test for 100 inode in all of the 
idspace checks. 

-r blocks This option overrides the default test for /unix size + 400 
blocks when checking the root (/) file system. When the -r 
option is used, the /usr and /tmp file systems are not tested 
unless explicitly specified. 

-u blocks This option overrides the default test for 400 blocks when 
checking the /usr file system. When the -u option is used, the 
root (/) and /tmp file systems are not tested unless explicitly 
specified. If /usr is not a separate file system, an error is 
reported. 

-t blocks This option overrides the default test for 400 blocks when 
checking the /tmp file system. When the -t option is used, the 
root (/) and /usr file systems are not tested unless explicitly 
specified. If /tmp is not a separate file system, an error is 
reported. 
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ERROR MESSAGES 

An exit value of zero indicates success. If insufficient space exists in a file 
system or an error was encountered due to a syntax or format error, idspace 
will report a message. All error messages are designed to be self- 
explanatory. The specific exit values are as follows: 

success. 

1 command syntax error, or needed file does not exist. 

2 file system has insufficient space or inodes. 

3 requested file system does not exist (-u and -t options only). 

SEE ALSO 

idbuild(lm), idinstall(lm). 
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NAME 

idtune - attempts to set value of a tunable parameter 
SYNOPSIS 

/etc/conf/bin/idtune [ -f I -m ] name value 
DESCRIPTION 

This script attempts to set the value of a tunable parameter. The tunable 
parameter to be changed is indicated by name. The desired value for the 
tunable parameter is value. 

If there is already a value for this parameter (in the stune file), the user will 
normally be asked to confirm the change with the following message: 

Tunable Parameter name is currently set to old— value. 
Is it OK to change it to value? (y/n) 

If the user answers y, the change will be made. Otherwise, the tunable 
parameter will not be changed, and the following message will be 
displayed: 

name left at old— value. 

However, if the -f (force) option is used, the change will always be made 
and no messages will ever be given. 

If the -m (minimum) option is used and there is an existing value which is 
greater than the desired value, no change will be made and no message will 
be given. 

If system tunable parameters are being modified as part of a device driver or 
application add-on package, it may not be desirable to prompt the user with 
the above question. The add-on package Install script may chose to over- 
ride the existing value using the -f or -m options. However, care must be 
taken not to invalidate a tunable parameter modified earlier by the user or 
another add-on package. 

In order for the change in parameter to become effective, the UNIX system 
kernel must be rebuilt and the system rebooted. 

DIAGNOSTICS 

The exit status will ne non-zero if errors are encountered. 

SEE ALSO 

idbuild(l). 

mtune(4), stune(4) in the Programmer's Reference Manual. 
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NAME 

infocmp - compare or print out terminfo descriptions 
SYNOPSIS 

infocmp [-d] [-C] [-n] [-1] [-L] [-C] [-r] [-u] [-s dlilllc] [-v] [-V] [-1] [-w 
width] [-A directory] [-B directory] [termname ...] 

DESCRIPTION 

The infocmp command can be used to compare a binary terminfo (A) entry 
with other terminfo entries, rewrite a terminfo{^) description to take advan- 
tage of the use= terminfo field, or print out a terminfo{4) description from 
the binary file [term{4)] in a variety of formats. In all cases, the Boolean 
fields will be printed first, followed by the numeric fields, followed by the 
string fields. 

Default Options 

If no options are specified and zero or one termnames are specified, the -I 
option will be assumed. If more than one termname is specified, the -d 
option will be assumed. 

Comparison Options [-d] [-c] [-n] 

The infocmp command compares the terminfo (^) description of the first ter- 
minal termname with each of the descriptions given by the entries for the 
other terminal's termnames. If a capability is defined for only one of the ter- 
minals, the value returned will depend on the type of the capability: F for 
boolean variables, -1 for integer variables, and NULL for string variables. 

-d produce a list of each capability that is different. In this manner, if 
one has two entries for the same terminal or similar terminals, 
using infocmp will show what is different between the two entries. 
This is sometimes necessary when more than one person produces 
an entry for the same terminal and one wants to see what is dif- 
ferent between the two. 

-c produce a list of each capability that is common between the two 
entries. Capabilities that are not set are ignored. This option can 
be used as a quick check to see if the -u option is worth using. 

-n produce a list of each capability that is in neither entry. If no term- 
names are given, the environment variable TERM will be used for 
both of the termnames. This can be used as a quick check to see if 
anything was left out of the description. 

Source Listing Options [-1] [-L] [-C] [-r] 

The -I, -L, and -C options will produce a source listing for each terminal 
named. 

-I use the terminfo{4) names 

-L use the long C variable name listed in <term.h> 
-C use the termcap names 

-r when using -C, put out all capabilities in termcap form 

If no termnames are given, the environment variable TERM will be used for 
the terminal name. 
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The source produced by the -C option may be used directly as a termcap 
entry, but not all of the parameterized strings may be changed to the 
termcap format, infocmp will attempt to convert most of the parameterized 
information, but that which it doesn't will be plainly marked in the output 
and commented out. These should be edited by hand. 
All padding information for strings will be collected together and placed at 
the beginning of the string where termcap expects it. Mandatory padding 
(padding information with a trailing '/') will become optional. 
All termcap variables no longer supported by terminfo(A), but which are 
derivable from other terminfo(A) variables, will be output. Not all ter- 
minfo(4) capabilities will be translated; only those variables which were part 
of termcap will normally be output. Specifying the -r option will take off 
this restriction, allowing all capabilities to be output in termcap form. 
Note that because padding is collected to the beginning of the capability, 
not all capabilities are output, mandatory padding is not supported, and 
termcap strings were not as flexible; it is not always possible to convert a 
terminfo{4) string capability into an equivalent termcap format. Not all of 
these strings will be able to be converted. A subsequent conversion of the 
termcap file back into terminfo(A) format will not necessarily reproduce the 
original terminfo{A) source. 

Some common terminfo parameter sequences, their termcap equivalents, and 
some terminal types which commonly have such sequences are: 

Terminfo 

%pl%c 
%pl%d 
%pl%V%-l-%c 
%i 

%pl%?%V%>%t%pl%y%+%; 
%p2 is printed before %pl 

Use= Option [-u] ^ . r. • ^ ^ 

-u produce a terminfo(4:) source description of the first terminal term- 
name which is relative to the sum of the descriptions given by the 
entries for the other terminals' termnames. It does this by analyz- 
ing the differences between the first termname and the other term- 
names and producing a description with use= fields for the other 
terminals. In this manner, it is possible to retrofit generic terminfo 
entries into a terminal's description. Or, if two similar terminals 
exist, but were coded at different times or by different people so 
that each description is a full description, using infocmp will show 
what can be done to change one description to be relative to the 
other. 

A capability will get printed with an at-sign (@) if it no longer exists in the 
first termname, but one of the other termname entries contains a value for it. 
A capability's value gets printed if the value in the first termname is not 
found in any of the other termname entries, or if the first of the other 



Termcap 


Representative Terminals 


%. 


adm 


%d 


hp, ANSI standard, vtlOO 


%+x 


concept 


%i 


ANSI standard, vtlOO 


%>xy 


concept 


%r 


hp 
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termname entries that has this capability gives a different value for the capa- 
bility than that in the first termname. 

The order of the other termname entries is significant. Since the terminfo 
compiler tic (IM) does a left- to-right scan of the capabilities, specifying two 
use= entries that contain differing entries for the same capabilities will pro- 
duce different results depending on the order that the entries are given. 
infocmp will flag any such inconsistencies between the other termname 
entries as they are found. 

Alternatively, specifying a capability after a use= entry that contains that 
capability will cause the second specification to be ignored. Using infocmp 
to recreate a description can be a useful check to make sure that everything 
was specified correcdy in the original source description. 

Another error that does not cause incorrect compiled files, but will slow 
down the compilation time, is specifying extra use= fields that are superflu- 
ous, infocmp will flag any other termname use= fields that were not 
needed. 

Other Options [-s dlilllc] [-v] [-V] [-1] [-w width] 

-s sort the fields within each type according to the argument below: 

d leave fields in the order that they are stored in the terminfo 
data base. 

i sort by terminfo name. 

1 sort by the long C variable name. 

c sort by the termcap name. 

If no -s option is given, the fields printed out will be sorted alpha- 
betically by the terminfo name within each type, except in the case 
of the -C or the -L options, which cause the sorting to be done by 
the termcap name or the long C variable name, respectively. 

-V print out tracing information on standard error as the program 
runs. 

-V print out the version of the program in use on standard error and 
exit. 

-1 cause the fields to print out one to a line. Otherwise, the fields 

will be printed several to a line to a maximum width of 60 charac- 
ters. 

-w change the output to width characters. 

Changing Data Bases [-A directory] [-B directory] 

The location of the compiled terminfo{4) data base is taken from the 
environment variable TERMINFO. If the variable is not defined or the ter- 
minal is not found in that location, the system terminfo{4) data base, usually 
in /usr/lib/terminfo, will be used. The options -A and -B may be used to 
override this location. The -A option will set TERMINFO for the first term- 
name and the -B option will set TERMINFO for the other termnames. With 
this, it is possible to compare descriptions for a terminal with the same 



- 3 - 



INFOCMP{lM) 



(Extended Terminal Interface) 



INFOCMP(IM) 



name located in two different data bases. This is useful for comparing 
descriptions for the same terminal created by different people. Otherwise 
the terminals would have to be named differently in the terminfo(4) data 
base for a comparison to be made. 

FILES 

/usr/lib/terminfo/?/* compiled terminal description data base 

DIAGNOSTICS 

malloc is out of space! 

There was not enough memory available to process all the 
terminal descriptions requested. Run infocmp several 
times, each time including a subset of the desired term- 
names. 

use= order dependency found: 

A value specified in one relative terminal specification was 
different from that in another relative terminal specifica- 
tion. 

'use=term' did not add anything to the description. /fl 

A relative terminal name did not contribute anything to 
the final description. 

must have at least two terminal names for a comparison to be done./fl 

The -u, -d, and -c options require at least two terminal 
names. 

SEE ALSO 

captoinfo(lM). ^ „ . 

tic(lM), curses(3X), term(4), terminfo(4) in the Programmers Reference 

Manual. 

Chapter 10 of the Programmer's Guide. 

^^^^ The termcap data base (from earlier releases of UNIX System V) may not be 
supplied in future releases. 
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NAME 

init, telinit - process control initialization 

SYNOPSIS 

/etc/init [ 0123456SsQqabc ] 

/etc/telinit [ 0123456SsQqabc ] 

DESCRIPTION 
Init 

init is a general process spawner. Its primary role is to create processes 
from information stored in the file /etc/inittab [see inittab(4)]. 

At any given time, the system is in one of eight possible run levels. A run 
level is a software configuration of the system under which only a selected 
group of processes exist. The processes spawned by init for each of these 
run levels is defined in /etc/inittab. init can be in one of eight run levels, 
0-6 and S or s (run levels S and s are identical). The run level changes 
when a privileged user runs /etc/init. This user-spawned init sends 
appropriate signals to the original init spawned by the operating system 
when the system was booted, telling it which run level to change to. 

The following are the arguments to init: 

shut the machine down so it is safe to remove the power. 
Have the machine remove power if it can. This state can be 
executed only from the console. 

1 put the system in single-user mode. Unmount all file sys- 
tems except root. All user processes are killed except those 
connected to the console. This state can be executed only 
from the console. 

2 put the system in multiuser mode. All multiuser environ- 
ment terminal processes and daemons are spawned. This 
state is commonly referred to as the multiuser state. 

3 start the remote file sharing processes and daemons. Mount 
and advertise remote resources. Run level 3 extends mul- 
tiuser mode and is known as the remote-file-sharing state. 

4 is available to be defined as an alternative multiuser 
environment configuration. It is not necessary for system 
operation and is usually not used. 

5 Stop the UNIX system and go to the firmware monitor. 

6 Stop the UNIX system and reboot to the state defined by the 
initdefault entry in /etc/inittab. 

a,b,c process only those /etc/inittab entries having the a, b or c 
run level set. These are pseudo-states, which may be 
defined to run certain commands, but which do not cause 
the current run level to change. 

Q,q re-examine /etc/inittab. 
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S,s enter single-user mode. When this occurs, the terminal 
which executed this command becomes the system console. 
This is the only run level that doesn't require the existence 
of a properly formatted /etc/inittab file. If this file does 
not exist, then by default the only legal run level that init 
can enter is the single-user mode. When the system enters 
S or s, all mounted file systems remain mounted and only 
processes spawned by init are killed. 

When a UNIX system is booted, init is invoked and the following occurs. 
First, init looks in /etc/inittab for the initdefault entry [see inittab{4)]. If 
there is one, init uses the run level specified in that entry as the initial run 
level to enter. If there is no initdefault entry in /etc/inittab, init requests 
that the user enter a run level from the virtual system console. If an S or s 
is entered, init goes to the single-user state. In the single-user state, the vir- 
tual console terminal is assigned to the user's terminal and is opened for 
reading and writing. The sulogin command, which requires the user to enter 
the root password, is invoked and a message is generated on the physical 
console saying where the virtual console has been relocated. Use either init 
or telinit to signal init to change the run level of the system. Note that if 
the shell is terminated (via an end-of-file), init will only re-initialize to the 
single-user state if the /etc/inittab file does not exist. 

If a through 6 is entered, init enters the corresponding run level. Note 
that, on the 80386 computer, the run levels 0, 1, 5, and 6 are reserved states 
for shutting the system down; the run levels 2, 3, and 4 are available as nor- 
mal operating states. 

On your computer, the run-levels and 1 are reserved states for shutting the 
system down, and run-levels 2, 3, and 4 are available as normal operating 
states. 

If this is the first time since power up that init has entered a run level other 
than single-user state, init first scans /etc/inittab for boot and bootwait 
entries [see inittab(4)]. These entries are performed before any other pro- 
cessing of /etc/inittab takes place, providing that the run level entered 
matches that of the entry. In this way, any special initialization of the 
operating system, such as mounting file systems, can take place before users 
are allowed onto the system, init then scans /etc/inittab and executes all 
other entries that are to be processed for that run level. 
In a multiuser environment, /etc/inittab is set up so that init will create a 
getty process for each terminal that the administrator sets up to respawn. 
To spawn each process in /etc/inittab, init reads each entry and for each 
entry that should be respawned, it forks a child process. After it has 
spawned all of the processes specified by /etc/inittab, init waits for one of 
its descendant processes to die, a powerfail signal, or a signal from another 
init or telinit process to change the system's run level. When one of these 
conditions occurs, init re-examines /etc/inittab. New entries can be added 
to /etc/inittab at any time; however, init still waits for one of the above 
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three conditions to occur before re-examining /etc/inittab. To get around 
this, an init Q or init q command wakes init to re-examine /etc/inittab 
immediately. 

When init comes up at boot time and whenever the system changes from 
the single-user state to another run state, init sets the ioctl{2) states of the 
virtual console to those modes saved in the file /etc/ioctl.syscon. This file 
is written by init whenever the single-user state is entered. 

When a run level change request is made, init sends the warning signal 
(SIGTERM) to all processes that are undefined in the target run level, init 
waits 5 seconds before forcibly terminating these processes via the kill sig- 
nal (SIGKILL). 

The shell running on each terminal will terminate when the user types an 
end-of-file or hangs up. When init receives a signal telling it that a process 
it spawned has died, it records the fact and the reason it died in /etc/utmp 
and /etc/wtmp if it exists [see ivhoil)]. A history of the processes spawned 
is kept in /etc/wtmp. 

If init receives a powerfail signal (SIGPWR) it scans /etc/inittab for special 
entries of the type powerfail and powerwait. These entries are invoked (if 
the run levels permit) before any further processing takes place. In this way 
init can perform various cleanup and recording functions during the power- 
down of the operating system. Note that in the single-user states, S and s, 
only powerfail and powerwait entries are executed. 

telinit 

telinit, which is linked to /etc/init, is used to direct the actions of init. It 
takes a one-character argument and signals init to take the appropriate 
action. 

FILES 

/etc/inittab 

/etc/utmp 

/etc/wtmp 

/etc/ioctl.syscon 

/dev/console 

/dev/contty 

SEE ALSO 

getty(lM), login(l), sh(l), shutdown(lM), stty(l), who(l), sulogin(lM), ter- 
mio(7). 

kill(2), gettydefs(4), inittab(4), utmp(4), in the Programmer's Reference 
Manual. 

DIAGNOSTICS 

If init finds that it is respawning an entry from /etc/inittab more than 10 
times in 2 minutes, it will assume that there is an error in the command 
string in the entry, and generate an error message on the system console. It 
will then refuse to respawn this entry until either 5 minutes has elapsed or 
it receives a signal from a user-spawned init (telinit). This prevents init 
from eating up system resources when someone makes a typographical 
error in the inittab file or a program is removed that is referenced in 
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/etc/inittab. 

When attempting to boot the system, failure of init to prompt for a new run 
level may be because the virtual system console is linked to a device other 
than the physical system console. 

WARNINGS 

init and telinit can be run only by someone who is super-user. 
The S or s state must not be used indiscriminately in the /etc/inittab file. 
A good rule to follow when modifying this file is to avoid adding this state 
to any line other than the initdefault. 

The change to /etc/gettydefs described in the WARNINGS section of the 
gettydefs(A) manual page will permit terminals to pass 8 bits to the system 
as long as the system is in multiuser state (run level greater than 1). When 
the system changes to single-user state, the getty is killed and the terminal 
attributes are lost. To permit a terminal to pass 8 bits to the system in 
single-user state, after you are in single-user state, type: 

stty -istrip csS 
The /etc/TIMEZONE file must exist. 
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NAME 

install - install commands 
SYNOPSIS 

/etc/install [-c dira] [-f dirb] [-i] [-n dire] [-m mode] [-u user] 
[-g group] [-0] [-S] file [dirx . . .] 

DESCRIPTION 

The install command is most commonly used in "makefiles" [see make(l)] 
to install a file (updated target file) in a specific place within a file system. 
Each file is installed by copying it into the appropriate directory, thereby 
retaining the mode and owner of the original command. The program 
prints messages telling the user exactly what files it is replacing or creating 
and where they are going. 

If no options or directories (dirx . . .) are given, install will search a set of 
default directories (/bin, /usr/bin, /etc, /lib, and /usr/Iib, in that order) 
for a file with the same name as jfile. When the first occurrence is found, 
install issues a message saying that it is overwriting that file with file, and 
proceeds to do so. If the file is not found, the program states this and exits 
without further action. 

If one or more directories (dirx . . .) are specified after file, those directories 
will be searched before the directories specified in the default list. 

The meanings of the options are: 

-c dira Installs a new command (file) in the directory speci- 

fied by dira, only if it is not found. If it is found, 
install issues a message saying that the file already 
exists, and exits without overwriting it. May be used 
alone or with the -s option. 

-f dirb Forces file to be installed in given directory, whether 

or not one already exists. If the file being installed 
does not already exist, the mode and owner of the 
new file will be set to 755 and bin, respectively. If 
the file already exists, the mode and owner will be 
that of the already existing file. May be used alone or 
with the -o or -s options. 

-i Ignores default directory list, searching only through 

the given directories (dirx . . .). May be used alone or 
with any other options except -c and -f . 

-n dire If file is not found in any of the searched directories, 

it is put in the directory specified in dire. The mode 
and owner of the new file will be set to 755 and bin, 
respectively. May be used alone or with any other 
options except -c and -f . 

-m mode The mode of the new file is set to mode. Only avail- 

able to the superuser. 

-u user The owner of the new file is set to user. Only avail- 

able to the superuser. 
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-g group The group id of the new file is set to group. Only 

available to the superuser. 

-o If file is found, this option saves the "found" file by 

copying it to OLDfile in the directory in which it was 
found. This option is useful when installing a fre- 
quently used file such as /bin/sh or /etc/getty, where 
the existing file cannot be removed. May be used 
alone or with any other options except -c. 

-s Suppresses printing of messages other than error mes- 

sages. May be used alone or with any other options. 



SEE ALSO 

make(l) in the Programmer's Reference Manual. 
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NAME 

installpkg - install package 

SYNOPSIS 

installpkg 

DESCRIPTION 

The installpkg command is used to install a UNIX system software package. 

You will have to be root to install certain packages successfully. 

You will be prompted to insert the floppy disk that the installation package 
resides on. Everything else is automatic. 

LIMITATIONS 

You must invoke installpkg on the console. 

SEE ALSO 

displaypkg(l), removepkg(l). 
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NAME 

ipcrm - remove a message queue, semaphore set, or shared memory id 

SYNOPSIS 

ipcrm [ options ] 

DESCRIPTION 

The ipcrm command will remove one or more specified messages, sema- 
phore or shared memory identifiers. The identifiers are specified by the fol- 
lowing options: 

-q msqid removes the message queue identifier msqid from the system 
and destroys the message queue and data structure associated 
with it. 

-m shmid removes the shared memory identifier shmid from the system. 

The shared memory segment and data structure associated 
with it are destroyed after the last detach. 

-s semid removes the semaphore identifier semid from the system and 
destroys the set of semaphores and data structure associated 
with it. 

-Q msgkey removes the message queue identifier, created with key 
msgkey, from the system and destroys the message queue and 
data structure associated with it. 

-M shmkey removes the shared memory identifier, created with key 
shmkey, from the system. The shared memory segment and 
data structure associated with it are destroyed after the last 
detach. 

-S semkey removes the semaphore identifier, created with key semkey, 
from the system and destroys the set of semaphores and data 
structure associated with it. 

The details of the removes are described in msgctl(2), shmctl(2), and 
semctl(2). The identifiers and keys may be found by using ipcs{l). 

SEE ALSO 

ipcs(l). 

msgctl(2), msgget(2), msgop(2), semctl(2), semget(2), semop(2), shmctl(2), 
shmget(2), shmop(2) in the Programmer's Reference Manual. 
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NAME 

ipcs - report inter-process communication facilities status 

SYNOPSIS 

ipcs [ options ] 

DESCRIPTION 

ipcs prints certain information about active inter-process communication 
facilities. Without options, information is printed in short format for mes- 
sage queues, shared memory, and semaphores that are currently active in 
the system. Otherwise, the information that is displayed is controlled by 
the follov^ing options: 

-q Print information about active message queues. 

-m Print information about active shared memory segments. 

-s Print information about active semaphores. 

If any of the options -q, -m, or -s are specified, information about only 
those indicated will be printed. If none of these three are specified, infor- 
mation about all three will be printed subject to these options: 

-a Use all print options. (This is a shorthand notation for -b, -c, -o, 
-p, and -t.) 

-b Print biggest allowable size information. (Maximum number of 
bytes in messages on queue for message queues, size of segments 
for shared memory, and number of semaphores in each set for 
semaphores.) See below for meaning of columns in a listing. 

-c Print creator's login name and group name. See below. 

-o Print information on outstanding usage. (Number of messages on 
queue and total number of bytes in messages on queue for message 
queues and number of processes attached to shared memory seg- 
ments.) 

-p Print process number information. (Process ID of last process to 
send a message and process ID of last process to receive a message 
on message queues and process ID of creating process and process 
ID of last process to attach or detach on shared memory segments) 
See below. 

-t Print time information. (Time of the last control operation that 

changed the access permissions for all facilities. Time of last 
msgsnd and last msgrcv on message queues, last shmat and last 
shmdt on shared memory, last semop{2) on semaphores.) See 
below. 

-C corefile 

Use the file corefile in place of /dev/kmem. 
-N namelist 

The argument will be taken as the name of an alternate namelist 
(/unix is the default). 
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-X Print information about XENIX interprocess communication, in 
addition to the standard interprocess communication status. The 
XENIX process information describes a second set of semaphores 
and shared memory. Note that the -p option does not print process 
number information for XENIX shared memory, and the -t option 
does not print time information about XENIX semaphores and 
shared memory. 

The column headings and the meaning of the columns in an ipcs listing are 
given below. The letters in parentheses indicate the options that cause the 
corresponding heading to appear; all means that the heading always 
appears. Note that these options only determine what information is pro- 
vided for each facility; they do not determine which facilities will be listed. 

T (all) 

Type of the facility: 

q message queue 

m shared memory segment 

s semaphore. 

ID (all) 

The identifier for the facility entry. 

KEY (all) 

The key used as an argument to msgget, semget, or shmget 
to create the facility entry. (Note: The key of a shared 
memory segment is changed to IPC_PRIVATE when the 
segment has been removed until all processes attached to 
the segment detach it.) 

MODE (all) 

The facility access modes and flags: The mode consists of 
11 characters that are interpreted as follows: 

The first two characters are: 

R if a process is waiting on a msgrcv. 
S if a process is waiting on a msgsnd. 
D if the associated shared memory segment has 

been removed. It will disappear when the last 

process attached to the segment detaches it. 
C if the associated shared memory segment is to be 

cleared when the first attach is executed. 

if the corresponding special flag is not set. 

The next 9 characters are interpreted as three sets of three 
bits each. The first set refers to the owner's permissions. 
The next set refers to permissions of others in the user- 
group of the facility entry. The last set refers to all others. 
Within each set, the first character indicates permission to 
read, the second character indicates permission to write or 
alter the facility entry, and the last character is currently 
unused. Permissions are indicated as follows: 
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r if read permission is grar\ted 
w if write permission is granted 
a if alter permission is granted 

if the indicated permission is not granted. 



(all) 
(all) 



(a,c) 
(a,c) 



(a,o) 



The login name of the owner of the facility entry. 

) 

The group name of the group of the owner of the facility 
entry. 

) 

The login name of the creator of the facility entry. 

) 

The group name of the group of the creator of the facility 
entry. 



(a,o) 



The number of bytes in messages currently outstanding on 
the associated message queue. 



(a,b) 



The number of messages currently outstanding on the 
associated message queue. 



(a,p) 



(a,p) 



(a,t) 



(a,t) 



(a,t) 



(a,o) 



(a,b) 



The maximum number of bytes allowed in messages out- 
standing on the associated message queue. 

') 

The process ID of the last process to send a message to the 
associated queue. 

The process ID of the last process to receive a message 
from the associated queue. 

I 

The time the last message was sent to the associated 
queue. 

I 

The time the last message was received from the associ- 
ated queue. 

I 

The time when the associated entry was created or 
changed. 

) 

The number of processes attached to the associated shared 
memory segment. 



(a,p) 

1 

(a,p) 



The size of the associated shared memory segment. 



The process ID of the creator of the shared memory entry. 



The process ID of the last process to attach or detach the 
shared memory segment. 
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ATIME 



DTIME 



NSEMS 



OTIME 



(a,t) 



(a,t) 



(a,b) 



(a,t) 



The time the last attach was completed to the associated 
shared memory segment. 

I 

The time the last detach was completed on the associated 
shared memory segment. 

') 

The number of semaphores in the set associated with the 
semaphore entry. 

) 

The time the last semaphore operation was completed on 
the set associated with the semaphore entry. 



FILES 



/unix system namelist 

/dev/kmem memory 

/etc/passwd user names 

/etc/group group names 

SEE ALSO 

msgop(2), semop(2), shmop(2) in the Programmer's Reference Manual. 
WARNING 

If the user specifies either the -C or -N flag, the real and effective 
UID/GID will be set to the real UID/GID of the user invoking ipcs. 

BUGS 

Things can change while ipcs is running; the picture it gives is only a close 
approximation to reality. 
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NAME 

ismpx - return windowing terminal state 

SYNOPSIS 

ismpx [-s] 

DESCRIPTION 

The ismpx command reports whether its standard input is connected to a 
multiplexed xt{7) channel; i.e., whether it's running under layers{l) or not. 
It is useful for shell scripts that download programs to a windowing termi- 
nal or depend on- screen size. 

The ismpx command prints yes and returns if invoked under layers(l), and 
prints no and returns 1 otherwise. 

-s Do not print anything; just return the proper exit status. 

EXIT STATUS 

Returns if invoked under layers{l), 1 if not. 

SEE ALSO 

jwin(l), layers(l), xt(7). 

EXAMPLE 

if ismpx -s 
then 

jwin 

fi 
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NAME 

join - relational data base operator 

SYNOPSIS 

join [ options ] filel file2 

DESCRIPTION 

The join command forms, on the standard output, a join of the two relations 
specified by the lines of filel and filel. If filel is -, the standard input is 
used. 

Filel and filel must be sorted in increasing ASCII collating sequence on the 
fields on which they are to be joined, normally the first in each line [see 
sort{l)]. 

There is one line in the output for each pair of lines in filel and filel that 
have identical join fields. The output line normally consists of the common 
field, then the rest of the line from filel, then the rest of the line from filel. 

The default input field separators are blank, tab, or new-line. In this case, 
multiple separators count as one field separator, and leading separators are 
ignored. The default output field separator is a blank. 

Some of the below options use the argument n. This argument should be a 
1 or a 2 referring to either filel or filel, respectively. The following options 
are recognized: 

-an In addition to the normal output, produce a line for each unpairable 
line in file n, where w is 1 or 2. 

-e s Replace empty output fields by string s. 

-jn m Join on the mth field of file n. If w is missing, use the mth field in 
each file. Fields are numbered starting with 1. 

-o list Each output line comprises the fields specified in list, each element 
of which has the form n,m, where n is a file number and m is a field 
number. The common field is not printed unless specifically 
requested. 

-tc Use character c as a separator (tab character). Every appearance of c 
in a line is significant. The character c is used as the field separator 
for both input and output. 

EXAMPLE 

The following command line will join the password file and the group file, 
matching on the numeric group ID, and outputting the login name, the 
group name, and the login directory. It is assumed that the files have been 
sorted in ASCII collating sequence on the group ID fields. 

join -jl 4 -j2 3 -o 1.1 2.1 1.6 -t: /etc/passwd /etc/group 

SEE ALSO 

awk(l), comm(l), sort(l), uniq(l). 

BUGS 

With default field separation, the collating sequence is that of sort -b; with 
-t, the sequence is that of a plain sort. 
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The conventions of join, sort, comm, uniq, and awk{l) are wildly incongru- 
ous. 

File names that are numeric may cause conflict when the -o option is used 
right before listing file names. 
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NAME 

jterm - reset layer of windowing terminal 

SYNOPSIS 

jterm 

DESCRIPTION 

The jterm command is used to reset a layer of a windowing terminal after 
downloading a terminal program that changes the terminal attributes of the 
layer. It is useful only under layers(l). In practice, it is most commonly 
used to restart the default terminal emulator after using an alternate one 
provided with a terminal-specific application package. For example, on the 
AT&T TELETYPE 5620 DMD terminal, after executing the hp2621{l) com- 
mand in a layer, issuing the jterm command will restart the default terminal 
emulator in that layer. 

EXIT STATUS 

Returns upon successful completion, 1 otherwise. 

NOTE 

The layer that is reset is the one attached to standard error; that is, the win- 
dow you are in when you type the jterm command. 

SEE ALSO 

layers(l). 
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NAME 

jwin - print size of layer 

SYNOPSIS 

jwin 

DESCRIPTION 

The jwin command runs only under layers(l) and is used to determine the 
size of the layer associated with the current process. It prints the width and 
the height of the layer in bytes (number of characters across and number of 
lines, respectively). For bit-mapped terminals only, it also prints the width 
and height of the layer in bits. 

EXIT STATUS 

Returns on successful completion, 1 otherwise. 

DIAGNOSTICS 

If layers{l) has not been invoked, an error message is printed: 
jwin: not mpx 

NOTE 

The layer whose size is printed is the one attached to standard input; that 
is, the window you are in when you type the jwin command. 

SEE ALSO 

layers(l). 

EXAMPLE 

jwin 

bytes: 86 25 
bits: 780 406 
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NAME 

kill - terminate a process 

SYNOPSIS 

kill [ -signo ] PID ... 

DESCRIPTION 

The kill command sends signal 15 (terminate) to the specified processes. 
This will normally kill processes that do not catch or ignore the signal. The 
process number of each asynchronous process started with & is reported by 
the shell (unless more than one process is started in a pipeline, in which 
case the number of the last process in the pipeline is reported). Process 
numbers can also be found by using ps{l). 

The details of the kill are described in kill{2). For example, if process 
number is specified, all processes in the process group are signaled. 

The killed process must belong to the current user unless he is the super- 
user. 

If a signal number preceded by - is given as first argument, that signal is 
sent instead of terminate [see signal(2)]. In particular, "kill -9 ..." is a sure 
kill. 

SEE ALSO 

ps(l), sh(l). 

kill(2), signal(2) in the Programmer's Reference Manual 
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NAME 

killall - kill all active processes 

SYNOPSIS 

/etc/killall [ signal ] 

DESCRIPTION 

The killall command is used by /etc/shutdown to kill all active processes 
not directly related to the shutdown procedure. 

The killall command terminates all processes with open files so that the 
mounted file systems will be unbusied and can be unmounted. 

The killall command sends signal [see kill(l)] to all processes not belonging 
to the above group of exclusions. If no signal is specified, a default of 9 is 
used. 

FILES 

/etc/shutdown 

SEE ALSO 

fuser(lM), kill(l), ps(l), shutdown(lM). 
signal(2) in the Programmer's Reference Manual, 

WARNINGS 

The killall command can be run only by the super-user. 
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NAME 

labelit - provide labels for file systems 
SYNOPSIS 

/etc/labelit special [ fsname volume [ -n ] ] 
DESCRIPTION 

The labelit command can be used to provide labels for unmounted disk file 
systems or file systems being copied to tape. The -n option provides for 
initial labeling only. (This destroys previous contents.) 

With the optional arguments omitted, labelit prints current label values. 

The special name should be the physical disk section (e.g., /dev/dsk/0s3). 
The device may not be on a remote machine. 

The fsname argument represents the mounted name (e.g., root, ul, etc.) of 
the file system. 

Volume may be used to equate an internal name to a volume name applied 
externally to the disk pack, diskette, or tape. 

For file systems on disk, fsname and volume are recorded in the super block. 

SEE ALSO 

sh(l). 

fs(4) in the Programmer's Reference Manual. 
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NAME 

layers - layer multiplexer for windowing terminals 
SYNOPSIS 

layers [-s] [-t] [-d] [-p] [-f file] [layersys-prgm] 
DESCRIPTION 

The layers command manages asynchronous windows [see layers(5)] on a 
windowing terminal. Upon invocation, layers finds an unused xt(7) channel 
group and associates it with the terminal line on its standard output. It then 
waits for commands from the terminal. 

Command-line options: 

-s Reports protocol statistics on standard error at the end of the ses- 
sion after you exit from layers. The statistics may be printed during 
a session by invoking the program xts{lM), 

-t Turns on xt(7) driver packet tracing, and produces a trace dump on 

standard error at the end of the session after you exit from layers. 
The trace dump may be printed during a session by invoking the 
program xtt(lM). 

-d If a firmware patch has been downloaded, prints out the sizes of 
the text, data, and bss portions of the firmware patch on standard 
error. 

-p If a firmware patch has been downloaded, prints the downloading 
protocol statistics and a trace on standard error. 

-i file Starts layers with an initial configuration specified by file. Each 
line of the file represents a layer to be created, and has the follow- 
ing format: 

origin_x origin_y corner_x corner_y command—list 

The coordinates specify the size and position of the layer on the 
screen in the terminal's coordinate system. If all four are 0, the user 
must define the layer interactively, command— list, a list of one or 
more commands, must be provided. It is executed in the newlayer 
using the user's shell (by executing: $SHELL -i -c 
command— list''). This means that the last command should 
invoke a shell, such as /bin/sh. (If the last command is not a 
shell, then, when the last command has completed, the layer will 
not be functional.) 

layersys-prgm 

A file containing a firmware patch that the layers command down- 
loads to the terminal before layers are created and command— list is 
executed. 

Each layer is in most ways functionally identical to a separate terminal. 
Characters typed on the keyboard are sent to the standard input of the UNIX 
system process attached to the current layer (called the host process), and 
characters written on the standard output by the host process appear in that 
layer. When a layer is created, a separate shell is established and bound to 
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the layer. If the environment variable SHELL is set, the user will get that 
shell: otherwise, /bin/sh will be used. In order to enable communications 
with other users via wn^e(l), layers invokes the command relogin(lM) when 
the first layer is created. relogin(lM) will reassign that layer as the user's 
logged-in terminal. An alternative layer can be designated by using 
relogin{lM) directly, layers will restore the original assignment on termina- 
tion. 

Layers are created, deleted, reshaped, and otherwise manipulated in a 
terminal-dependent manner. For instance, the AT&T TELETYPE 5620 DMD 
terminal provides a mouse-activated pop-up menu of layer operations. The 
method of ending a layers session is also defined by the terminal. 

EXAMPLE 

layers -f startup 

where startup contains 

8 8 700 200 date ; pwd ; exec $SHELL 
8 300 780 850 exec $SHELL 

NOTES 

The xt(7) driver supports an alternate data transmission scheme known as 
ENCODING MODE. This mode makes layers operation possible even over 
data links which intercept control characters or do not transmit 8-bit charac- 
ters. ENCODING MODE is selected either by setting a configuration option 
on your windowing terminal or by setting the environment variable 
DMDLOAD to the value hex before running layers: 

export DMDLOAD; DMDLOAD=hex 

If, after executing layers -f file, the terminal does not respond in one or 
more of the layers, often the last command in the command-list for that 
layer did not invoke a shell. 

WARNING 

When invoking layers with the -s, -t, -d, or -p options, it is best to redirect 
standard error to another file to save the statistics and tracing output (e.g., 
layers -s 2>stats); otherwise all or some of the output may be lost. 

FILES 

/dev/xt??[0-7] 

/usr /lib /lay ersy s /Isy s . 8; 7;3 

/usr /lib /lay ersys /Isys. 8;?;? 

SEE ALSO 

relogin(lM), sh(l), write(l), wtinit(lM), xts(lM), xtt(lM), xt(7). 
libwindows(3X), layers(5) in the Programmer's Reference Manual. 
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NAME 

line - read one line 

SYNOPSIS 
line 

DESCRIPTION 

The line command copies one line (up to a new-line) from the standard 
input and writes it on the standard output. It returns an exit code of 1 on 
EOF and always prints at least a new-line. It is often used within shell files 
to read from the user's terminal. 

SEE ALSO 

sh(l). 

read(2) in the Programmer's Reference Manual. 
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NAME 

link, unlink - link and unlink files and directories 

SYNOPSIS 

/etc/link filel file2 
/etc/unlink file 

DESCRIPTION 

The link command is used to create a file name that points to another file. 
Linked files and directories can be removed by the unlink command; how- 
ever, it is strongly recommended that the rm{l) and rmdir{l) commands be 
used instead of the unlink command. 

The only difference between ln(l) and link/unlink is that the latter do 
exactly what they are told to do, abandoning all error checking. This is 
because they directly invoke the link(2) and unlink(2) system calls. 

SEE ALSO 

rm(l). 

link(2), unlink(2) in the Programmer's Reference Manual. 
WARNINGS 

These commands can be run only by the super-user. 
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NAME 

login - sign on 

SYNOPSIS 

login [ name [ env-var . . . ] ] 

DESCRIPTION 

The login command is used at the beginning of each terminal session and 
allows you to identify yourself to the system. It may be invoked as a com- 
mand or by the system when a connection is first established. Also, it is 
invoked by the system when a previous user has terminated the initial shell 
by typing a CTRL-D to indicate an " end-of-file. " 

If login is invoked as a command it must replace the initial command inter- 
preter. This is accomplished by typing: 

exec login 
from the initial shell. 

login asks for your user name (if not supplied as an argument), and, if 
appropriate, your password. Echoing is turned off (where possible) during 
the typing of your password, so it will not appear on the written record of 
the session. 

If you make a mistake in the login procedure you will receive the message 
Login incorrect 

and a new login prompt will appear. If you make five incorrect login 
attempts, all five may be logged in /usr/adm/loginlog (if it exists) and the 
line will be dropped. 

If you do not complete the login successfully within a certain period of time 
(e.g., one minute), you are likely to be silently disconnected. 

After a successful login, the user-ID, the group-ID, the working directory, 
and the command interpreter [usually sh{l)] is initialized. If the shell 
/bin/sh is running, accounting files are updated, the procedure 
/etc/profile is performed, the message-of-the-day (if any) is printed, and 
the file .profile in the working directory is executed, if it exists. If the shell 
/bin/csh is running, the .login and .cshrc files in the working directory are 
executed, if they exist. These specifications are found in the /etc/passwd 
file entry for the user. The name of the command interpreter is - followed 
by the last component of the interpreter's path name (i.e., -sh). If this field 
in the password file is empty, then the default command interpreter, 
/bin/sh is used. If this field is *, then the named directory becomes the 
root directory, the starting point for path searches for path names beginning 
with a /. At that point, login is re-executed at the new level which must 
have its own root structure, including /etc/login and /etc/passwd. 

The basic environment is initialized to: 

HOME=your-login-directory 
PATH=:/bin: /usr/bin 
SHELL=last-field-of-passiud-entry 
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MAIL= /usr / mail /your-login-name 
lZ=timezone'Sj)ecification 

The environment may be expanded or modified by supplying additional 
arguments to login, either at execution time or when login requests your 
login name. The arguments may take either the form xxx or xxx=yyy. 
Arguments without an equal sign are placed in the environment as 

Ln=xxx 

where n is a number starting at and is incremented each time a new vari- 
able name is required. Variables containing an = are placed into the 
environment without modification. If they already appear in the environ- 
ment, then they replace the older value. There are exceptions. The vari- 
ables HOME, PATH, SHELL, MAIL, IPS, TZ, HZ, CDPATH, and LOGNAME 
cannot be changed. This prevents people, logging into restricted shell 
environments, from spawning secondary shells which are not restricted. 
Both login and getty understand simple single-character quoting conven- 
tions. Typing a backslash in front of a character quotes it and allows the 
inclusion of such things as spaces and tabs. 

FILES 

/etc/utmp 
/etc/wtmp 
/ USX /mai\ /your-name 
/usr /adm /loginlog 
/etc/motd 
/etc/passwd 
/etc/profile 
.profile 

SEE ALSO 

mail(l), sh(l), newgrp(lM), su(lM). 

loginlog(4), passwd(4), profile(4), environ(5) in the Programmer's Reference 
Manual. 

DIAGNOSTICS 

login incorrect if the user name or the password cannot be matched. 

No shell, cannot open password file, or no directory: consult a UNIX system 
programming counselor. 

No utmp entry. You must exec "login" from the lowest level "sh" if you 
attempted to execute login as a command without using the shell's exec 
internal command or from other than the initial shell. 

NOTES 

The file /etc/default/login contains special login information including the 
flag PASSREQ. When PASSREQ is set to YES (PASSREQ=YES), users will 
be required to have a password. When a user without a password logs in 
and PASSREQ=YES, the user will be forced to add a password before the 
user is allowed access to the system. One exception to this requirement is if 
password aging is turned on for the user and the NULL password has not 
been aged. In this case, the user will be allowed to access the system 



accounting 
accounting 

mailbox for user your-name 
record of failed login attempts 
message-of-the-day 
password file 

system profile (/bin/sh only) 
user's login profile (/bin/sh only) 
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without a password until the NULL password has been aged, or until the 
root user forces the password to be aged {passwd -f command). 
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NAME 

logname - get login name 

SYNOPSIS 

logname 

DESCRIPTION 

The logname command returns the contents of the environment variable 
$LOGNAME, which is set when a user logs into the system. 

FILES 

/etc/profile 

SEE ALSO 

env(l), login(l). 

logname(3X), environ(5) in the Programmer's Reference Manual. 
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NAME 

Ip, cancel - send/cancel requests to an LP print service 

SYNOPSIS 

Ip [printing options] files 

Ip -i id printing options 

cancel [ids] [printers] 

DESCRIPTION 

The first form of the Ip shell command arranges for the named files and 
associated information (collectively called a request) to be printed. If no file 
names are specified on the shell command line, the standard input is 
assumed. The standard input may be specified along with named files on 
the shell command line using the file name. The files will be printed in the 
order they appear on the shell command line. 

The second form of Ip is used to change the options for a request. The print 
request identified by the request-id is changed according to the printing 
options specified with this shell command. The printing options available 
are the same as those with the first form of the Ip shell command. If 
request-id has finished printing, the change is rejected. If the request-id is 
already printing, it will be stopped and restarted from the beginning, unless 
the -P option has been given. 

Ip associates a unique id with each request and prints it on the standard out- 
put. This id can be used later to cancel, change, or find the status of the 
request. (See the section on cancel for details about canceling a request, the 
previous paragraph for an explanation of how to change a request, and 
lpstat(l) for information about checking the status of a print request.) 

Sending a Print Request 

The first form of the Ip command is used to send a print request to a partic- 
ular printer or group of printers. 

Options to Ip must always precede file names but may be listed in any 
order. The following options are available for Ip: 

-c Makes copies of the files to be printed immediately when Ip is 
invoked. Normally, files will not be copied. If the -c option is not 
given, then the user should be careful not to remove any of the 
files before the request has been printed in its entirety. It should 
also be noted that in the absence of the -c option, any changes 
made to the named files after the request is made but before it is 
printed will be reflected in the printed output. 

-d dest Prints this request using dest as the printer or class of printers. 

Under certain conditions (lack of printer availability, capabilities of 
printers, and so on), requests for specific destinations may not be 
accepted [see accept{lM) and lpstat{l)]. By default, dest is taken 
from the environment variable LPDEST (if it is set). Otherwise, a 
default destination (if one exists) for the computer system is used. 
Destination names vary between systems [see lpstat{l)]. 
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-f form-name [-d any] 

Prints the request on the form form-name. The LP print service 
ensures that the form is mounted on the printer. If form-name is 
requested with a printer destination that cannot support the form, 
the request is rejected. If form-name has not been defined for the 
system or if the user is not allowed to use the form, the request is 
rejected [see lpforms(lM)]. When the -d any option is given, the 
request is printed on any printer that has the requested form 
mounted and can handle any other needs of the print request. 

-H special-handling 

Prints the request according to the value of special-handling. 
Acceptable values for special-handling are hold, resume, and 
immediate, as defined below: 

hold Won't print the request until notified. If already printing, 
stops it. Other print requests will go ahead of a held 
request until it is resumed. 

resume Resumes a held request. If it had been printing when 
held, it will be the next request printed, unless subse- 
quently bumped by an immediate request. 

immediate 

(Available only to LP administrators) 

Prints the request next. If more than one request is 
assigned immediate, the requests are printed in the 
reverse order queued. If a request is currently printing on 
the desired printer, you have to put it on hold to allow the 
immediate request to print. 

-m Sends mail [see mail(l)] after the files have been printed. By 
default, no mail is sent upon normal completion of the print 
request. 

-n number 

Prints number copies of the output. (Default is 1.) 

-o option 

Specifies printer-dependent or class-dependent options. Several 
such options may be collected by specifying the -o keyletter more 
than once. The standard interface recognizes the following 
options: 

nobanner 

Does not print a banner page with this request. (The 
administrator can disallow this option at any time.) 

nofilebreak 

Does not insert a form feed between the files given if sub- 
mitting a job to print more than one file. 

lengih=scaled-decimal-number 

Prints the output of this request with pages scaled-decimal- 
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number lines long. A scaled-decimal-number is an optionally 
scaled decimal number that gives a size in lines, columns, 
inches, or centimeters, as appropriate. The scale is indicated 
by appending the letter "i" (for inches) or the letter "c" (for 
centimeters). For length or width settings, an unsealed 
number indicates lines or columns; for line pitch or character 
pitch settings, an unsealed number indicates lines per inch or 
characters per inch (the same as a number scaled with "i"). 
For example, length=66 indicates a page length of 66 lines, 
length=lli indicates a page length of 11 inches, and 
length=27.94c indicates a page length of 27.94 centimeters. 

This option cannot be used with the -f option. 

vfidih=scaled-decimal-number 

Prints the output of this request with page-width set to 
scaled-decimal-number columns wide. (See the explanation 
above for scaled-decimal-numbers.) This option cannot be 
used with the -f option. 

lpi=scaled-decimal-number 

Prints this request for "lines per inch" with the line pitch 
set to scaled-decimal-number lines per inch. This option can- 
not be used with the -f option. 

cpi=scaled-decimal-number 

Prints this request for "characters per inch" with the charac- 
ter pitch set to scaled-decimal-number characters per inch. 
Character pitch can also be set to pica (representing 10 
columns per inch) or elite (representing 12 columns per 
inch), or it can be compressed, which is as many columns as 
a printer can handle. There is no standard number of 
columns per inch for all printers; see the terminfo(4) database 
for the default character pitch for your printer. The cpi 
option cannot be used in conjunction with the -f option. 

stiy=stty-option-list 

A list of options valid for the stty command. Enclose the 
list with quotes if it contains blanks. 

-P page-list 

Prints the page specified in page-list. This option can be used only 
if there is a filter available to handle it; otherwise, the print request 
will be rejected. 

The page-list may consist of range(s) of numbers, single page 
numbers, or a combination of both. The pages will be printed in 
ascending order. 

-q priority-level 

Assigns this request priority-level in the printing queue. The values 
of priority-level range from 0, the highest priority, to 39, the lowest 
priority. If a priority is not specified, the default for the print ser- 
vice is used, as assigned by the system administrator. 
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-s Suppresses messages from lp(l) such as "request id is ..." . 

-S character-set [-d any] 

-S print-wheel [-d any] 

Prints this request using the specified character-set or print-wheel 
If a form has been specified that requires a character-set or print- 
wheel other than the one specified with the -S option, the request 
is rejected. 

For printers that take print wheels: if the print-wheel specified is 
not one listed by the administrator as acceptable for the printer 
involved in this request, the request is rejected unless the print 
wheel is already mounted on the printer. For printers that use 
selectable or programmable character sets: if the character-set 
specified is not one defined in the Terminfo database for the 
printer [see terminfo(^)] or is not an alias defined by the administra- 
tor, the request is rejected. 

When the -d any option is used, the request is printed on any 
printer that has the print wheel mounted or any printer that can 
select the character set and can handle any other needs of the 
request. 

-t title Prints title on the banner page of the output. The default is no 
title. 

-T content-type [-r] 

Prints the request on a printer that can support the specihed 
content-type. If no printer accepts this type directly, a filter will be 
used to convert the content into an acceptable type. If the -r 
option is specified, a filter will not be used. If -r is specified but 
no printer accepts the content-type directly, the request is rejected. 
If the content-type is not acceptable to any printer, either directly or 
with a filter, the request is rejected. 

-w Writes a message on the user's terminal after the files have been 
printed. If the user is not logged in, then mail will be sent instead. 

-y mode-list 

Prints this request according to the printing modes listed m mode- 
list. The allowed values for mode-list are locally defined. This 
option can be used only if there is a filter available to handle it; if 
there is no filter, the print request will be rejected. 

Canceling a Print Request . u .u 

The cancel command cancels printer requests that were made by the lp(l) 
shell command. The shell command line arguments may be either request- 
ids [as returned by lp(l)] or printer names [for a complete list, use lpstat(l)]. 
Specifying a request-id cancels the associated request even if it is currently 
printing. Specifying a printer cancels the request that is currently printing 
on that printer. In either case, the cancellation of a request that is currently 
printing frees the printer to print its next available request. 

NOTES 

Printers for which requests are not being accepted will not be considered 
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when the destination is any. (Use the Ipstat -a command to see which 
printers are accepting requests.) On the other hand, if a request is destined 
for a class of printers and the class itself is accepting requests, all printers in 
the class will be considered, regardless of their acceptance status, as long as 
the printer class is accepting requests. 

WARNING 

For printers that take mountable print wheels or font cartridges, if you do 
not specify a particular print wheel or font with the -S option, whichever 
happens to be mounted at the time your request prints will be used. Use 
the Ipstat -p -1 command to see what print wheels are available. For 
printers that have selectable character sets, you will get the standard set if 
you don't give the -S option. 

FILES 

/usr/spool/lp/* 
SEE ALSO 

enable(l), Ipstat(l), mail(l), accept(lM), Ipadmin(lM), Ipfilter(lM), 
Ipforms(lM), Ipsched(lM), Ipusers(lM). 

terminfo(4) in the Programmer's Reference Manual. 
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NAME 

Ipadmin - configure the LP print service 

SYNOPSIS 

/usr/lib/lpadmin -p printer options 
/usr/lib/lpadmin -x dest 
/usr/lib/lpadmin -d [dest] 

/usr/lib/lpadmin -S print-wheel -A alert-type [-W integer^ ] 
[-Q integer 2 ] 
DESCRIPTION 

Ipadmin configures the LP print service to describe printers and devices. It is 
used to add and change printers, to remove printers from the service, to set 
or change the system default destination, and to define alerts for print 
wheels. 

Adding or Changing a Printer . , . , 

The first form of the Ipadmin command (Ipadmin -p printer options) is used 
to configure a new printer or to change the configuration of an existing 
printer. The following options are used and may appear in any order. For 
ease of discussion, the printer will be referred to as P below. 

-F fault-recovery 

Restores the LP print service after a printer fault according to the value 
of fault-recovery: 

continue 

Continues printing on the top of the page where printing 
stopped. This requires a filter to wait for the fault to clear 
before automatically continuing. 

beginning 

Starts printing the request again from the beginning, 
wait Disables printing on the printer and waits for the administra- 
tor or a user to enable printing again. 

During the wait, the administrator or the user who submitted 
the stopped print request can issue a change request that 
specifies where printing should resume. If no change request 
is made before printing is enabled, printing will resume at the 
top of the page where stopped if the filter allows; otherwise, 
the request will be printed from the beginning. 

This option specifies the recovery to be used for any print request that 

is stopped because of a printer fault. 

-c class 

Inserts printer P into the specified class, class will be created if it does 
not already exist. 
-D comment 

Saves comment for display whenever a user asks for a full description 
of the printer P [see lpstat(l)]. The LP print service does not interpret 
this comment. 
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-e printer 

Copies an existing printer's interface program to be the new interface 
program for printer P. 

-f SLllovfiform-list 
-f deny:form-list 

Allows (-f allow) or denies (-f deny) the forms in form-list to be 
printed on printer P. 

For each printer, the LP print service keeps two lists of forms: an 
"allow-list" of forms that can be used with the printer and a "deny- 
list" of forms that shouldn't be used with the printer. With the -f 
allow option, the forms listed are added to the allow-list and removed 
from the deny-list. With the -f deny option, the forms listed are 
removed from the allow-list and added to the deny-list. 

If the allow-list is not empty, the forms in the list can be used with the 
printer and all others cannot regardless of the content of the deny-list. 
If the allow-list is empty but the deny-list is not, the forms in the 
deny-list cannot be used with the printer. All forms can be excluded 
from a printer by having an empty allow-list and putting the word 
any in the deny-list. All forms can be used on a printer by having an 
empty deny-list and specifying any for the allow-list, provided the 
printer can handle all the characteristics of the forms. 

The LP print service uses this information as a set of guidelines for 
determining where a form can be mounted. Administrators, however, 
are not restricted from mounting a form on any printer. If mounting a 
form on a particular printer is in disagreement with the information in 
the allow-list or deny-list, the administrator is warned, but the mount 
is accepted. Nonetheless, if a user attempts to issue a print or change 
request for a form and printer combination that is in disagreement 
with the information, the request is accepted only if the form is 
currently mounted on the printer. If the form is later unmounted 
before the request can print, the request is canceled, and the user is 
notified by mail. 

If an administrator tries to name a form as acceptable for use on a 
printer that doesn't have the capabilities needed by the form, the com- 
mand is rejected. 

Note the other use of -f below. 

-h Indicates that the device associated with P is hardwired. This option 
is assumed when adding a new printer unless the -1 option is sup- 
plied. 

-i interface 

Establishes a new interface program for P. interface is the path name 
of the new program. 

-I content-type-list 

Assigns P to handle print requests with content of a type listed in 
content-type-list. 
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The type simple is recognized as the default content-type of files in 
the UNIX system. Such a data stream contains only printable ASCII 
characters and the following control characters: 

Control Character Octal Value Meaning 

10 move back to previous column, 
except at beginning of line 

11 move to next tab stop 

12 move to beginning of next line 

14^ move to beginning of next page 

15 move to beginning of current line 

8 

To force the print service to not consider simple as a valid type for 
the printer, give an explicit value (e.g., the printer type) in the 
content-type-list. If you do want simple included along with other 
types, you must include simple in the content-type-list. 
Each printer automatically has its printer type included in the list of 
content types it will accept. 

Except for simple, each content-type name is freely determined by the 
administrator. If names given as content types are also printer types, 
the names are accepted without comment because the LP print service 
recognizes all printer types as potential content types as well. 
-1 Indicates that the device associated with P is a login terminal. The LP 
scheduler, Ipsched, disables all login terminals automatically each time 
it is started. Before re-enabling P, its current device should be esta- 
blished using Ipadmin. 

-M -f form-name [-a [-o filebreak]] 

Mounts the form form-name on P. Print requests to be printed with 
the pre-printed form form-name will be printed on P. If more than one 
printer has the form mounted and the user has specified any (with 
the -d option of the Ip command) as the printer destination, then each 
print request will be printed on the one that meets the other needs of 
the request. 

The page length and width and character and line pitches needed by 
the form are compared with those allowed for the printer by checking 
the capabilities in the terminfo(4) database for the type of printer. If 
the form requires attributes that are not available with the printer, the 
administrator is warned, but the mount is accepted. If the form lists a 
prin't wheel as mandatory but the print wheel mounted on the printer 
is different, the administrator is also warned but the mount is 
accepted. 

If the -a option is given, an alignment pattern is printed, preceded by 
the same initialization of the physical printer that precedes a normal 
print request with one exception: no banner page is printed. Printing 
is assumed to start at the top of the first page of the form. After the 
pattern is printed, the administrator can adjust the mounted form in 
the printer, press return for another alignment pattern (no initialization 



backspace 
tab 

linefeed (newline) 
form feed 
carriage return 
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this time), and continue printing as many alignment patterns as 
desired. The administrator can quit the printing alignment patterns by 
typing "q". 

If the -o filebreak option is given, a formfeed is inserted between 
each copy of the alignment pattern. By default, the alignment pattern 
is assumed to correctly fill a form, so no formfeed is added. 

A form is unmounted by mounting a new form in its place using the 
-f option. The -f none option can be used to specify no form. By 
default, a new printer has no form mounted. 

Note the other use of -f above. 
-M -S print-wheel 

Mounts the print wheel print-wheel on P. Print requests to be printed 
with print-wheel will be printed on P. If more than one printer has 
the print-wheel mounted and the user has specified any (with the -d 
option of the Ip command) as the printer destination, then each print 
request will be printed on the one that meets the other needs of the 
request. 

If the print-wheel is not listed as acceptable for the printer, the 
administrator is warned, but the mount is accepted. If the printer does 
not take print wheels, the command is rejected. 

A print wheel is unmounted by mounting a new print wheel in its 
place or by using the -S none option. 

By default, a new printer has no special print wheel mounted. Until 
this is changed, a print request that asks for a specific print wheel will 
not be printed on P. 

Note the other uses of the -S option described below, 
-m model 

Selects a model interface program provided with the LP print service 
for printer P. 

-o printing-option 

Each -o option in the list below is the default given to an interface 
program if the option is not taken from a preprinted form description 
or is not explicitly given by the user submitting a request [see lp(l)]. 
The only -o options that can have defaults defined are listed below: 

leng,th=scaled-decimal-number 

viidth=scaled-decimal-number 

cpi=scaled-decimal-number 

lpi=scaled-decimal-number 

stty=stty-option-list 

The term scaled-decimal-number refers to a non-negative number used 
to indicate a unit of size. (The type of unit is shown by a trailing 
letter attached to the number.) Three types of scaled decimal numbers 
are discussed for the LP print service: numbers that show sizes in 
centimeters (marked with a trailing c), numbers that show sizes in 
inches (marked with a trailing i), and numbers that show sizes in units 
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appropriate to use (without a trailing letter), i.e., lines, columns, lines 
per inch, or characters per inch. 

The first four default option values should agree with the capabilities 
of the type of physical printer as defined in the terminfo(4) database 
for the printer type. If they do not, the command is rejected. 
The stty-option-list is not checked for allowed values but is passed 
directly to the stty(l) program by the standard interface program. Any 
error messages produced by stty{l) when a request is processed (by 
the standard interface program) are mailed to the user submitting the 
request. 

For each printing option not specified, the defaults for the following 
attributes are defined in the Terminfo entry for the specified printer 
type: 

length 
width 
cpi 
Ipi 

The default for stty is 

stty=9600 cs8 -cstopb -parenb -paroff ixon 

-ixany opost -olcuc -onlcr -ocrnl -onocr 
-onlret -ofill nlO crO tabO bsO vtO ffO 

You can set any of the -o options to the default values (which vary for 
different types of printers) by typing them without assigned values as 
follows: 

length= 

width= 

cpi= 

lpi= 

stty= 

-o nobanner 

Allows users to submit a print request that asks that no banner page 
be printed, 
-o banner 

Forces a banner page to be printed with every print request, even 
when a user asks for no banner page. This is the default; you must 
specify -o nobanner if you want to allow users to specify -o 
nobanner with the Ip command. 

-r class 

Removes printer P from the specified class. If P is the last member of 
the class, then the class will be removed. 

Slist 

Allows the aliases for character sets or print wheels named in list to be 
used with P. 

If the printer is a type that takes print wheels, then list is a list of print 
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wheel names separated by commas or spaces. These will be the only 
print wheels considered mountable on the printer. (You can always 
force a different print wheel to be mounted, however.) Until the 
option is used to specify a list, no print wheels will be considered 
mountable on the printer, and print requests that ask for a particular 
print wheel with this printer will be rejected. 

If the printer is a type that has selectable character sets, then list is a 
list of character set name mappings or aliases separated by commas or 
spaces. Each mapping is of the form 

known-name = synonym 

known-name is a character set number preceded by cs, such as cs3 for char- 
acter set three, or a character set name from the Terminfo database csnm 
entry. [See terminfo(4) in the Programmer's Reference Manual.] If this option 
is not used to specify a list, only the names already known from the Ter- 
minfo database or numbers with a prefix of cs will be acceptable for the 
printer. 

If list is the word none, the previous print wheel list or character set aliases 
will be removed. 

Note the other uses of the -S option. 
-T printer-type 

Assigns the given printer-type, a representation of a physical printer of 
type printer-type. Printer-type is used to extract data from terminfo(4); 
this data is used to initialize the printer before printing each user's 
request. Some filters may also use printer-type to convert content for 
the printer. If this option is not used, the default printer-type will be 
unknown; no useful information will be extracted from terminfo{^), so 
each user request will be printed without first initializing the printer. 
Also, this option must be used if the following are to work: -o cpi=, 
-o lpi=, -o width=, and -o length= options of the Ipadmin and Ip 
commands, and the -S and -f options of the Ipadmin command. 

-u a\\o-w:user-list 
-u deny:user-list 

Allows (-U allow) or denies (-u deny) the users in user-list access to 
P. 

For normal access to each printer, the LP print service keeps two lists 
of users: an allow-list of people allowed to use the printer and a 
deny-list of people denied access to the printer. With the -u allow 
option, the users listed are added to the allow-list and removed from 
the deny-list. With the -u deny option, the users listed are removed 
from the allow-list and added to the deny-list. 

If the allow-list is not empty, the users in the list are allowed access to 
the printer and all others are denied access, regardless of the content 
of the deny-list. If the allow-list is empty but the deny-list is not, the 
users in the deny-list are denied access and all others are allowed. If 
both lists are empty, all users are allowed access. Access can be 
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denied to all users except the LP print service administrator by putting 
any in the allow-list. To allow everyone access to P and effectively 
empty both lists, put any in the allow-list. 

-U dial-info 

Assigns the dialing information dial-info to the printer, dial-info is 
used with the dial(3) routine to call the printer. Any network connec- 
tion supported by the Basic Networking Utilities will work, dial-info 
can be either a phone number for a modem connection or a system 
name for other kinds of connections. Or if -U direct is given, no dial- 
ing will take place because the name direct is reserved for a printer 
that is directly connected. If a system name is given, it is used to 
search for connection details from the file /usr/lib/uucp/Systems or 
related files. The Basic Networking Utilities are required to support 
this option. By default, -U direct is assumed. 

-V device 

Associates a new device with printer P. device is the path name of a 
file that is writable by Ip. Note that the same device can be associated 
with more than one printer. 

-A alert-type [-W integer] 

The -A option is used to send the alert alert-type to the administrator 
when a printer fault is detected and periodically thereafter until the 
printer fault is cleared by the administrator. The alert-types are 

mail Sends the alert message via mail [see mail(l)] to the adminis- 
trator who issues this command. 

write Writes the message to the terminal on which the administrator 
is logged in. If the administrator is logged in on several termi- 
nals, one is chosen arbitrarily. 

quiet Does not send messages for the current condition. An 
administrator can use this option to temporarily stop receiving 
further messages about a known problem. Once the fault has 
been cleared and printing resumes, messages will again be sent 
when another fault occurs with the printer. 

none Does not send messages until this command is given again 
with a different alert-type; removes any existing alert defini- 
tion. No alert will be sent when the printer faults until a dif- 
ferent alert-type is used (except quiet). 

shell-command 

shell-command is run each time the alert needs to be sent. 
shell-command should expect the message as standard input. If 
there are blanks embedded in the command, enclose the com- 
mand in quotes. Note that the mail and write values for this 
option are equivalent to the values mail user-name and write 
user-name, respectively, where user-name is the current name 
for the administrator. This will be the login name of the per- 
son submitting this command unless he or she has used the su 
command to change to another user ID. If the su command 
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has been used to change the user ID, then the user-name for 
the new ID is used. 

list The type of the alert for the printer fault is displayed on the 
standard output. No change is made to the alert. 

The message sent appears as follows: 

The print wheel print-wheel needs to be mounted 

on the printer(s): 

printer-list 

number-of-requests print requests await this print-wheel. 

The printer printer-name has stopped printing for the reason given below. 
Fix the problem and bring the printer back on line. Printing has stopped 
but will be restarted in a few minutes; issue an enable command if you 
want to restart sooner. 

Unless someone issues a change request 

Ip -i request-id -P . . . 

to change the page-list to print, the current request will be repeated from 
the beginning. 

The reason(s) it stopped (multiple reasons indicate reprinted attempts): 
reason 

The LP print service can detect printer faults only through an adequate fast 
filter and only when the standard interface program or a suitable custom- 
ized interface program is used. Furthermore, the level of recovery after a 
fault depends on the capabilities of the filter. 

If the printer-name is all, the alerting defined in this command applies to all 
existing printers. 

If the -W option is not given or integer ^ is zero (which represents once and 
is also the default), only one message will be sent per fault. If this com- 
mand is not used to arrange fault alerting for a printer, the default pro- 
cedure is to mail one message to the administrator of the printer per fault. 
Restrictions 

When creating a new printer, either the -v or the -U option must be sup- 
plied. In addition, only one of the following may be supplied: -e, -i, or 
-m; if none of these three options are supplied, the model standard is used. 
The -h and -1 keyletters are mutually exclusive. Printer and class names 
may be no longer than 14 characters and must consist entirely of the char- 
acters A-Z, a-z, 0-9 and (underscore). 

Removing a Printer Destination 

The -X dest option removes the destination dest from the LP print service. If 
dest is a printer and is the only member of a class, then the class will be 
deleted, too. If dest is all, all printers and classes are removed. No other 
options are allowed with -x. 
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Changing the System Default Destination 

The -d [dest] option makes dest, an existing destination, the new system 
default destination. If dest is not supplied, then there is no system default 
destination. No other options are allowed with -d. 

Setting an Alert for a Print Wheel 

-S print-wheel -A alert-type [-W integer^ ] [-Q integer2 ] 

The -S print-wheel option is used with the -A alert-type option to 
send the alert alert-type to the administrator as soon as the print-wheel 
needs to be mounted and periodically thereafter. The alert-types are 

mail Sends the alert message via mail [see mail{l)] to the adminis- 
trator who issues this command. 

write Writes the message to the terminal on which the administra- 
tor is logged in. If the administrator is logged in on several 
terminals, one is chosen arbitrarily. 

quiet Does not send messages for the current condition. An 
administrator can use this option to temporarily stop receiv- 
ing further messages about a known problem. Once the 
print-wheel has been mounted and subsequently unmounted, 
messages will again be sent when the number of print 
requests again exceeds the threshold. 

none Does not send messages until this command is given again 
with a different alert-type (other than quiet). 

shell-command 

The shell-command is run each time the alert needs to be sent. 
The shell command should expect the message as standard 
input. If there are blanks embedded in the command, enclose 
the command in quotes. Note that the mail and write values 
for this option are equivalent to the values mail user-name 
and write user-name, respectively, where user-name is the 
current name for the administrator. This will be the login 
name of the person submitting this command unless he or 
she has used the su command to change to another user ID. 
If the su command has been used to change the user ID, then 
the user-name for the new ID is used. 

list The type of the alert for the print wheel is displayed on the 
standard output. No change is made to the alert. 

The printers listed are those that the administrator had earlier specified 
were candidates for this print wheel. The number ( integer^ ) listed 
next to each printer is the number of requests eligible for the printer. 
The number ( integer^ ) shown after the printer list is the total number 
of requests awaiting the print wheel. It will be less than the sum of 
the other numbers if some requests can be handled by more than one 
printer. 

If the print-wheel is all, the alerting defined in this command applies 
to all print wheels already defined to have an alert. 
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If the -W option is not given or integer ^ is zero (which is interpreted 
as once and is also the default), only one message will be sent per 
need to mount a print wheel. If this command is not used to arrange 
alerting for a print wheel, no alerts will be sent for the print wheel. 

If the -Q option is also given, the alert will be made when integer 2 
print requests that need the print wheel are waiting. If the -Q option 
is not given or integer 2 is 1 or the word any, a message is sent as soon 
as anyone submits a print request for the print wheel when it is not 
mounted. 

The -S option has a different meaning when used with the -p option. 

FILES 

/usr/spool /Ip /* 
SEE ALSO 

accept(lM), enable(l), lp(l), Ipstat(l), stty(l), Ipsched(lM). 
dial(3), terminfo(4) in the Programmer's Reference Manual 
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NAME 

Ipfilter - administer filters used with the LP print service 
SYNOPSIS 

/usr/lib/lpfilter -f filter-name -F path-name 

/usr/lib/lpfilter -f filter-name - 

/usr/lib/lpfilter -f filter-name -i 

/usr/lib/lpfilter -f filter-name -x 

/usr/lib/lpfilter -f filter-name -I 

DESCRIPTION 

The Ipfilter command is used to add, change, delete, and list filters used 
with the LP print service. These filters are used to convert the content type 
of a file to a content type acceptable to a given printer. One of the follow- 
ing options must be used with the Ipfilter command: -F path-name (or - for 
standard input) to add or change a filter, -i to reset an original LP print ser- 
vice filter to its factory setting, -x to delete a filter, or -1 to list a filter 
description. 

The argument all can be used instead of a filter-name with any of these 
options. When all is specified with the -F or - option, the requested 
change is made to all filters. Using all with the -i option has the effect of 
restoring to their original settings all filters for which predefined settings 
were initially available. Using the all argument with the -1 option produces 
a list of all filters, and using it with the -x option results in all filters being 
deleted. 

Adding or Changing a Filter 

The filter named in the -f option and described in the input is added to the 
filter table. If the filter already exists, its description is changed to reflect 
the new information in the input. Once added, a filter is available for use. 

The filter description is taken from the path-name if the -F option is given 
or from the standard input if the - option is given. One of the two must be 
given to define or change a filter. If the filter named is one originally 
delivered with the LP print service, the -i option will restore the original 
filter description. 

Filters are used to convert the content of a request into a data stream 
acceptable to a printer. For a given print request, the LP print service will 
know the following: 

the type of content in the request 
the name of the printer 
the type of the printer 

- the types of content acceptable to the printer 

- the modes of printing asked for by the originator of the request 

It will use this information to find a filter that will convert the content into 
a type acceptable to the printer. 
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Below is a list of items that provide input to this command and descriptions 
of each item. All lists are separated by commas or spaces. 

Input types: content-type-list 
Output types: content-type-list 
Printer types: printer-type-list 
Printers: printer-list 
Filter type: filter-type 
Command: shell-command 
Options: template-list 

Input types 

This gives the types of content that can be accepted by the filter. 
Output types 

This gives the types of content that the filter can produce from any 
of the input content types. 

Printer types 

This gives the type of printers for which the filter can be used. The 
LP print service will restrict the use of the filter to these types of 
printers. 

Printers 

This gives the names of the printers for which the filter can be used. 
The LP print service will restrict the use of the filter to just the 
printers named. 

Filter type 

This marks the filter as a ''slow" filter or a ''fast'' filter. Slow filters 
are generally those that take a long time to convert their input. 
They are run unconnected to a printer to keep the printers from 
being tied up while the filter is running. Fast filters are generally 
those that convert their input quickly or those that must be con- 
nected to the printer when run. These will be given to the interface 
program to run connected to the physical printer. 

Command 

This specifies the program to run to invoke the filter. The program 
name as well as fixed options are included in the shell-command; 
additional options are constructed, based on the characteristics of 
each print request and on the Options field. 

The command must accept a data stream as standard input and pro- 
duce the converted data stream on its standard output. This allows 
filter pipelines to be constructed to convert data not handled by a 
single filter. 

Options 

This is a list of templates separated by commas used by the LP print 
service to construct options to the filter from the characteristics of 
each print request listed in the table later. In general, each template 
is of the following form: 

keyword pattern = replacement 
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The keyword names the characteristic that the template attempts to 
map into a filter-specific option; each valid keyword is listed in the 
table below. A pattern is either a literal pattern of one of the forms 
listed in the table or a single asterisk, *; if the pattern matches the 
value of the characteristic, the template fits and is used to generate 
a filter-specific option. A pattern of * matches any value. The 
replacement is a string used as a filter-specific option with an 
embedded asterisk, *, replaced with the value of the characteristic. 



Ip Option 


Characteristic 


keyword 


Possible patterns 


-T 


Content type (input) 


INPUT 


content-type 


N/A 


Content type (output) 


OUTPUT 


content-type 


N/A 


Printer type 


TERM 


printer- type 


-f, -0 cpi= 


Character pitch 


CPI 


integer 


-f, -o lpi= 


Line pitch 


LPI 


integer 


-f, -0 length= 


Page length 


LENGTH 


integer 


-i, -0 width= 


Page width 


WIDTH 


integer 


-P 


Pages to print 


PAGES 


page-list 


-S 


Character set/ 


CHARSET 


character-set-name / 




print wheel 




print-wheel-name 


-f 


Form name 


FORM 


form-name 


-y 


Modes 


MODES 


mode 


-n 


Number of copies 


COPIES 


integer 



For example, the template 

MODES landscape = -1 

would show that if a print request includes the -y landscape 
option, the filter should be given the option -1. As another exam- 
ple, the template 

TERM * = -T * 

would show that the filter should be given the option -T printer- 
type for whichever printer-type is associated with a print request 
using the filter. 

When an existing filter is changed with this command, items that are not 
specified in the new information are left as they were. When a new filter is 
added with this command, unspecified items are given default values. 

Note that a filter name and a command must be given. A filter with no 
input type value is assumed to work with any input type; this is also true 
for the output type, printer type, and printer values. 

Deleting a Filter 

The -X option is used to delete the filter specified in filter-name from the LP 
filter table. 

Listing a Filter Description 

The -1 option is used to list the description of the filter named in filter- 
name. If the command is successful, the following message is sent to stan- 
dard output: 
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Input types : content-type-list 
Output types: content-type-list 
Printer types: printer-type-list 
Printers : printer-list 
Filter type: filter-type 
Command: shell-command 
Options : template-list 

If the command fails, an error message is sent to standard error. 

SEE ALSO 

Ipadmin(lM), lp(l). 
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NAME 

Ipforms - administer forms used with the LP print service 

SYNOPSIS 

/usr/lib/lpforms -f form-name option 

/usr/lib/lpforms -f form-name -A alert-type [-Q integer^] [-W integer^] 
/usr/lib/lpforms -f form-name -A list 
/usr/lib/lpforms -f form-name -A quiet 
/usr/lib/lpforms -f form-name -A none 
DESCRIPTION 

The Ipforms command is used to administer the use of preprinted forms, 
such as company letterhead paper, with the LP print service. The first vari- 
ation of the Ipforms command allows the administrator to add, change, and 
delete forms, to list the attributes of an existing form, and to allow and deny 
users access to particular forms. The second variation of Ipforms is used to 
establish the method by which the administrator is alerted that a form must 
be mounted on a printer. The third variation is used to list the current 
alerting methods assigned to forms. The form is specified by the form-name 
given with the Ipforms command. Users may request this form by form- 
name [see lp(l)]. The fourth variation of Ipforms is to terminate an active 
alert. The fifth form is used to remove an alert. 

With the first variation of the Ipforms command, one of the following 
options must be used: 

-F path-name To add or change a form as specified by the information 
in path-name 

To add or change a form, and supply information from 
standard input 

-X To delete a form 

This option must be used separately; it cannot be used 
with any other option. 

-1 To list the attributes of a form 

This option must be used separately; it cannot be used 
with any other option. 

-u Movfiuser-list To allow users to request a form 

This option can be used with the -F or - option. 

-u deny:user-list To deny users access to a form 

This option can be used with the -F or - option. 

Each option is explained below. 

Adding or Changing a Form 

The -F path-name option is used to add a new form to the LP print service, 
or to change the attributes of an existing form. The form description is 
taken from path-name if the -F option is given, or the standard input if the 
- option is given. One of the two options must be given to define or 
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change a form, path-name is the path name of a file that contains all or any 
subset of the following information about the form. 

Page length: scaled -decimal -number ^ 

Page width: scaled -decimal -number 2 

Number of pages: integer 

Line pitch: scaled -decimal -number ^ 

Character pitch: scaled -decimal -number ^ 

Character set choice: character-set /print-wheel,[msLndsitory] 

Ribbon color: ribbon-color 

Comment: 

comment 

Alignment pattern: [content -type] 
content 

Except for the last two lines, the above lines can appear in any order. The 
Comment: and comment items must appear in consecutive order but can 
appear before the other items, and the Alignment pattern: and the content 
items must appear in consecutive order at the end of the file. Also, the com- 
ment item cannot contain a line that begins with any of the key phrases 
above, unless the key phrase is preceded with a " > " sign. Any leading > 
sign found in the comment will be removed when the comment is displayed. 
Case distinctions in the key phrases are ignored. 

Upon issuing this command, the form named in form-name is added to the 
list of forms. If the form already exists, its description is changed to reflect 
the new information in the input. Once added, a form is available for use 
in a print request, except where access to the form has been restricted, as 
described under the -u allow: option. A form may also be allowed to be 
used on certain printers only. 

A description of each form attribute is below: 

Page length and Page width 

Before printing the content of a print request needing this form, the 
generic interface program provided with the LP print service will 
initialize the physical printer to handle pages 
scaled -decimal -number I long, and scaled -decimal -number 2 wide 
using the printer type as a key into the terminfo(4) database. A 
scaled-decimal-number is an optionally scaled decimal number that 
gives a size in lines, columns, inches, or centimeters, as appropriate. 
The scale is indicated by appending the letter 'i', for inches, or the 
letter 'c', for entimeters. For length or width settings, an unsealed 
number indicates lines or columns; for line pitch or character pitch 
settings, an unsealed number indicates lines per inch or characters 
per inch (the same as a number scaled with 'i'). For example, 
length=66 indicates a page length of 66 lines, length=lli indicates 
a page length of 11 inches, and length=27.94c indicates a page 
length of 27.94 centimeters. 

The page length and page width will also be passed, if possible, to 
each filter used in a request needing this form. 
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Number of pages 

Each time the alignment pattern is printed, the LP print service will 
attempt to truncate the content to a single form by, if possible, pass- 
ing to each filter the page subset of 1 -integer. 

Line pitch and Character pitch 

Before printing the content of a print request needing this form, the 
interface programs provided with the LP print service will initialize 
the physical printer to handle these pitches, using the printer type 
as a key into the terminfo{4) database. Also, the pitches will be 
passed, if possible, to each filter used in a request needing this form. 
Scaled -decimal -number^ is in lines per centimeter if a 'c' is 
appended, and lines per inch otherwise; similarly, 
scaled -decimal -number 4 is in columns per centimeter if a 'c' is 
appended, and columns per inch otherwise. The character pitch can 
also be given as elite (12 characters per inch), pica (10 characters 
per inch), or compressed (as many characters per inch as possible). 

Character set choice 

When the LP print service alerts an administrator to mount this 
form, it will also mention that the print wheel print-wheel should be 
used on those printers that take print wheels. If printing with this 
form is to be done on a printer that has selectable or loadable char- 
acter sets instead of print wheels, the interface programs provided 
with the LP print service will automatically select or load the correct 
character set. If mandatory is appended, a user is not allowed to 
select a different character set for use with the form; otherwise, the 
character set or print wheel named is a suggestion and a default 
only. 

Ribbon color 

When the LP print service alerts an administrator to mount this 
form, it will also mention that the color of the ribbon should be 
ribbon-color. 

Comment 

The LP print service will display the comment unaltered when a user 
asks about this form [see lpstat(l)]. 

Alignment pattern 

When mounting this form an administrator can ask that the content 
be repeatedly printed, as an aid in correctly positioning the pre- 
printed form. The optional content-type defines the type of printer 
for which content had been generated. If content-type is not given, 
simple is assumed. Note that the content is stored as given, and 
will be readable only by the user Ip. 

When an existing form is changed with this command, items missing in the 
new information are left as they were. When a new form is added with this 
command, missing items will get the following defaults: 

Page Length: 66 
Page Width: 80 
Number of Pages: 1 
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Line Pitch: 6 
Character Pitch: 10 
Character Set Choice: any 
Ribbon Color: any 
Comment: (no default) 
Alignment Pattern: (no default) 

Deleting a Form 

The -X option is used to delete the form specified in form-name from the LP 
print service. 

Listing Form Attributes 

The -1 option is used to list the attributes of the existing form specified by 
form-name. The attributes listed are those described under "Adding or 
Changing a Form", above. Because of the potentially sensitive nature of 
the alignment pattern, only the administrator can examine the form with 
this command. Other people can use the lpstat{l) command to examine the 
non-sensitive part of the form description. 

Allowing and Denying Access to a Form 

The LP print service keeps two lists of users for each form, an allow-list of 
people allowed to use the form, and a deny-list of people denied access to 
the form. With the -u allow: option, the users listed are added to the 
allow-list and removed from the deny-list. With the -u deny: option, the 
users listed are removed from the allow-list and added to the deny-list. 

If the allow-list is not empty, the users in the list are allowed access to the 
form and all others are denied access, regardless of the content of the 
deny-list. If the allow-list is empty, but the deny-list is not, the users in the 
deny-list are denied access and all others are allowed. If both lists are 
empty, all users are allowed access. Access can be denied to all users, 
except the LP print service administrator, by putting any in the deny-list. 
To effectively empty both lists, allowing access for everyone, put any in the 
allow-list. 

Alerting to Mount Forms 

The second variation of the Ipforms command is used to arrange for the 
alerting to mount forms on a printer. 

When integer I print requests needing the preprinted (orm form-name become 
queued up because no printer satisfying all the needs of the requests has the 
form mounted, and for as long as this condition remains, an alert is sent to 
the administrator every integer 2 minutes until the form is mounted on a 
qualifying printer. If the form-name is all, the alerting defined in this com- 
mand applies to all existing forms. No alerting is done for a backlog of 
print requests needing a form if the administrator does not use this option. 

The method for sending the alert depends on the value of the -A option. 

write The message is sent via write(l) to the terminal on which the 
administrator is logged in when the alert arises. If the administrator 
is logged in on several terminals, one is chosen arbitrarily. 
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mail The message is sent via mail to the administrator who issues this 
command. 

The message sent appears as follows: 

The form form-name needs to be mounted on the printer (s). 
printer-list (integer ^ requests) 

integer 4 print request awaits this form. 
Use the ribbon-color ribbon. 

Use the print-wheel print wheel, if appropriate. 

The printers listed are those that the administrator had earlier specified were 
candidates for this form. The number ( integer ^ ) listed next to each printer 
is the number of requests eligible for the printer. The number ( integer ^ ) 
shown after the printer list is the total number of requests awaiting the 
form. It will be less than the sum of the other numbers if some requests 
can be handled by more than one printer. The ribbon-color and print-wheel 
are those given in the form description. The last line in the message is 
given even if none of the printers listed use print wheels, because the 
administrator may choose to mount the form on a printer that does use a 
print wheel. 

Where any color ribbon or any print wheel can be used, the statements 
above will read: 

Use any ribbon. 

Use any print-wheel. 

shell-command 

The shell-command is run each time the alert needs to be sent. The 
shell command should expect the message as standard input. Note 
that the mail and write values for the -A command are equivalent 
to the values mail user-name and write user-name, respectively, 
where user-name is the current name for the administrator. This 
will be the login name of the person submitting this command 
unless he or she has used the su command to change to another 
user ID. If the su command has been used to change the user ID, 
then the user-name for the new ID is used. 

If the -Q option is not given or integer ^ is one or the word any (which is 
the default), a message is sent as soon as anyone submits a print request for 
the form when it is not mounted. 

If the -W option is not given or integer 2 is zero or the word once (which is 
the default), only one message is sent when the queue size exceeds integer i. 

Listing the Current Alert 

The third variation of Ipforms is used to list the type of the alert for the 
specified form. No change is made to the alert. If form-name is recognized 
by the LP print service, one of the following lines is sent to the standard 
output, depending on the type of alert for the form. 

Vitien integer are queued: alert \j±th. shell-command every 
integer minutes 
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]iJh.en integer are queued: write to user-name e^/ery integer 
minutes 

Vlhen integer are queued: mail to user-name every integer 
minutes 

No alert 

The phrase every integer minutes is replaced with once if integer 2 
(the -W integer 2 ) is 0. 

Terminating an Active Alert 

The quiet option is used to stop messages for the current condition. An 
administrator can use this option to temporarily stop receiving further mes- 
sages about a known problem, Once the form has been mounted and then 
unmounted, messages will again be sent when the queue size reaches 
integer I pending requests. 

Removing an Alert Definition 

No messages will be sent until the none option is given again with a dif- 
ferent alert-type. This can be used to permanently stop further messages 
from being sent. 

SEE ALSO 

lp(l), Ipadmin(lM). 

terminfo(4) in the Programmer's Reference Manual. 
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NAME 

Ipsched, Ipshut, Ipmove - start/stop the LP print service and move requests 

SYNOPSIS 

/usr /lib /Ipsched 
/usr/lib/lpshut 
/usr/lib/lpmove requests dest 
/usr/lib/lpmove destl dest2 

DESCRIPTION 

Ipsched starts the LP print service; this can be done only by root or Ip. 

Ipshut shuts down the print service. All printers that are printing at the 
time Ipshut is invoked will stop printing. When Ipsched is started again, 
requests that were printing at the time a printer was shut down will be 
reprinted from the beginning. 

Ipmove moves requests that were queued by Ip between LP destinations. 
The first form of the command moves the named requests to the LP destina- 
tion dest. Requests are jequest-ids as returned by Ip. The second form 
moves all requests for destination destl to destination destl; Ip will then 
reject any new requests for destl . 

Note that when moving requests, Ipmove never checks the acceptance status 
[see accept(lM)] of the new destination. Also, the request ID of the moved 
request is not changed so that users can still find their requests. The Ipmove 
command will not move requests that have options (content type, form 
required, and so on) that cannot be handled by the new destination. 

NOTE 

By default, the directory /usr/spool/lp is used to hold all the files used by 
the LP print service. This can be changed by setting the SPOOLDIR 
environment variable to another directory before running Ipsched. If you do 
this, you should populate the directory with the same files and directories 
found under /usr/spool/lp; the LP print service will not automatically 
create them. Also, the SPOOLDIR variable must then be set before any of 
the other LP print service commands are run. 

FILES 

/usr/spool/lp/* 
SEE ALSO 

enable(l), lp(l), Ipstat(l), accept(lM), Ipadmin(lM). 
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NAME 

Ipstat - print information about status of LP print service 

SYNOPSIS 

Ipstat [options] 

DESCRIPTION 

Ipstat prints information about the current status of the LP print service. 

If no options are given, then Ipstat prints the status of all requests made to 
lp{l) by the users. Any arguments that are not options are assumed to be 
request-ids (as returned by Ip), printers, or printer classes. Ipstat prints the 
status of such requests, printers, or printer classes. Options may appear in 
any order and may be repeated and intermixed with other arguments. 
Some of the keyletters below may be followed by an optional list that can 
be in one of two forms: a list of items separated from one another by a 
comma, or a list of items enclosed in double quotes and separated from one 
another by a comma and/or one or more spaces. For example: 

-u "userl, user 2, user3" 

Specifying " all " after any keyletters that take " list " as an argument causes 
all information relevant to the keyletter to be printed. For example, the 
command 

Ipstat -o all 
prints the status of all output requests. 

-a [list] Print acceptance status (with respect to Ip) of destinations for 
requests [see accept{lM)]. List is a list of intermixed printer 
names and class names; the default is all. 

-c [list] Print class names and their members. List is a list of class 
names; the default is all. 

-d Print the system default destination for Ip. 

-f [list] [-1] 

Print a verification that the forms in form-list are recognized by 
the LP print service. The -1 option will list the form descriptions. 

-o [list] [-1] 

Print the status of output requests. List is a list of intermixed 
printer names, class names, and request-ids; the default is all. 
The -1 option gives a more detailed status of the request. 

-P [list] [-D] [-1] 

Print the status of printers named in list. If the -D option is 
given, a brief description is printed for each printer in list. If the 
-1 option is given, a full description of each printer's configura- 
tion is given, including the form mounted, the acceptable content 
and printer types, a printer description, the interface used, and so 
on. 

-r Print the status of the LP request scheduler. 
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-s Print a status summary, including the system default destination, 

a list of class names and their members, a list of printers and 
their associated devices, a list of all forms currently mounted, and 
a list of all recognized character sets and print wheels. 

-S[/zsf][-l] 

Print a verification that the character sets or the print wheels 
specified in list are recognized by the LP print service. Items in 
list can be character sets or print wheels; the default for the list is 
all. If the -1 option is given, each line is appended by a list of 
printers that can handle the print wheel or character set. The list 
also shows whether the print wheel or character set is mounted 
or specifies the built-in character set into which it maps. 

-t Print all status information. 

-u [list] Print status of output requests for users. List is a list of login 
names. The default is all. 

-V [list] Print the names of printers and the path names of the devices 
associated with them. List is a list of printer names. The default 
is all. 

FILES 

/usr/spool/lp/* 

SEE ALSO 

enable(l), lp(l). 
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NAME 

Ipusers - set printing queue priorities 

SYNOPSIS 

/usr /lib /Ipusers 
/usr /lib /Ipusers 
/usr /lib /Ipusers 
/usr/lib/lpusers 
/usr /lib /Ipusers 

DESCRIPTION 

The Ipusers command is used to set limits to the queue priority level that 
can be assigned to jobs submitted by users of the LP print service. 

The first form of the command (with -d) sets the system-wide priority 
default to priority -level, where priority-level is a value of to 39, with 
being the highest priority. If a user does not specify a priority level with a 
print request [see lp(l)], the default priority is used. Initially, the default 
priority level is 20. 

The second form of the command (with -q and -u) sets the default highest 
priority-level (0-39) that the users in user-list can request when submitting 
a print request. Users that have been given a limit cannot submit a print 
request with a higher priority level than the one assigned, nor can they 
change a request already submitted to have a higher priority. Any print 
requests with priority levels higher than allowed will be given the highest 
priority allowed. 

The third form of the command (with -u) removes the users from any expli- 
cit priority level and returns them to the default priority level. 

The fourth form of the command (with -q) sets the default highest priority 
level for all users not explicitly covered by the use of the second form of 
this command. 

The last form of the command (with -1) lists the default priority level and 
the priority limits assigned to users. 

SEE ALSO 

lp(l). 



-d priority-level 

-q priority-level -u user-list 

-u user-list 

-q priority-level 

-1 
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NAME 

Is, Ic - list contents of directory 

SYNOPSIS 

Is [-RadCxmlnogrtucpFbqisf] [names] 
Ic [-RadxmlnogrtucpFbqisf] [names] 

DESCRIPTION 

For each directory argument. Is lists the contents of the directory; for each 
file argument. Is repeats its name and any other information requested. The 
output is sorted alphabetically by default. When no argument is given, the 
current directory is listed. When several arguments are given, the argu- 
ments are first sorted appropriately, but file arguments appear before direc- 
tories and their contents. 

Ic is a synonym for Is with the -C option set. There are three major listing 
formats. The default format is to list one entry per line, the -C and -x 
options enable multi-column formats, and the -m option enables stream 
output format. In order to determine output formats for the -C, -x, and -m 
options. Is uses an environment variable, COLUMNS, to determine the 
number of character positions available on one output line. If this variable 
is not set, the terminfo(^) data base is used to determine the number of 
columns, based on the environment variable TERM. If this information can- 
not be obtained, 80 columns are assumed. 

The Is command has the following options: 

-R Recursively list subdirectories encountered. 

-a List all entries, including those that begin with a dot (.), which are 
normally not listed. 

-d If an argument is a directory, list only its name (not its contents); 
often used with -1 to get the status of a directory. 

-C Multi-column output with entries sorted down the columns (default 
setting for Ic ), 

-X Multi-column output with entries sorted across rather than down 
the page. 

-m Stream output format; files are listed across the page, separated by 
commas. 

-1 List in long format, giving mode, number of links, owner, group, 
size in bytes, and time of last modification for each file (see below). 
If the file is a special file, the size field will instead contain the 
major and minor device numbers rather than a size. 

-n The same as -1, except that the owner's UID and group's GID 
numbers are printed, rather than the associated character strings. 

-o The same as -1, except that the group is not printed. 

-g The same as -1, except that the owner is not printed. 

-r Reverse the order of sort to get reverse alphabetic or oldest first as 
appropriate. 
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-t Sort by time stamp (latest first) instead of by name. The default is 
the last modification time. (See -n and -c.) 

-u Use time of last access instead of last modification for sorting (with 
the -t option) or printing (with the -1 option). 

-c Use time of last modification of the inode (file created, mode 
changed, etc.) for sorting (-t) or printing (-1). 

-p Put a slash (/) after each file name if that file is a directory. 

-F Put a slash (/) after each file name if that file is a directory and put 
an asterisk (*) after each file name if that file is executable. 

-b Force printing of non-printable characters to be in the octal \ddd 
notation. 

-q Force printing of non-printable characters in file names as the char- 
acter question mark (?). 

-i For each file, print the i-number in the first column of the report. 

-s Give size in blocks, including indirect blocks, for each entry. 

-f Force each argument to be interpreted as a directory and list the 
name found in each slot. This option turns off -1, -t, -s, and -r, 
and turns on -a; the order is the order in which entries appear in 
the directory. 

The mode printed under the -1 option consists of ten characters. The first 
character may be one of the following: 

d the entry is a directory; 

b the entry is a block special file; 

c the entry is a character special file; 

m the entry is a XENIX shred data (memory) file; 

p the entry is a fifo (a.k.a. "named pipe") special file; 

s the entry is a XENIX semaphore; 
the entry is an ordinary file. 

The next 9 characters are interpreted as three sets of three bits each. The 
first set refers to the owner's permissions; the next to permissions of others 
in the user-group of the file; and the last to all others. Within each set, the 
three characters indicate permission to read, to write, and to execute the file 
as a program, respectively. For a directory, "execute" permission is inter- 
preted to mean permission to search the directory for a specified file. 

Is -1 (the long list) prints its output as follows: 

-rwxrwxrwx 1 smith dev 10876 May 16 9:42 part2 

This horizontal configuration provides a good deal of information. Reading 
from right to left, you see that the current directory holds one file, named 
"part2." Next, the last time that file's contents were modified was 9:42 
A.M. on May 16. The file is moderately sized, containing 10,876 characters, 
or bytes. The owner of the file, or the user, belongs to the group "dev" 
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(perhaps indicating "development"), and his or her login name is "smith." 
The number, in this case "1," indicates the number of links to file "part2." 
Finally, the row of dash and letters tell you that user, group, and others 
have permissions to read, write, execute "part2." 

The execute (x) symbol here occupies the third position of the three- 
character sequence. A - in the third position would have indicated a denial 
of execution permissions. 

The permissions are indicated as follows: 

r the file is readable 

w the file is writable 

X the file is executable 

the indicated permission is not granted 

1 mandatory locking will occur during access (the set-group-ID bit 
is on and the group execution bit is off) 

s the set-user-ID or set-group-ID bit is on, and the corresponding 
user or group execution bit is also on 

S undefined bit-state (the set-user-ID bit is on and the user execu- 
tion bit is off) 

t the 1000 (octal) bit, or sticky bit, is on [see chmod{l)], and exe- 
cution is on 

T the 1000 bit is turned on, and execution is off (undefined bit- 
state) 

For user and group permissions, the third position is sometimes occupied by 
a character other than x or -. s also may occupy this position, referring to 
the state of the set-ID bit, whether it be the user's or the group's. The abil- 
ity to assume the same ID as the user during execution is, for example, used 
during login when you begin as root but need to assume the identity of the 
user stated at "login." 

In the case of the sequence of group permissions, 1 may occupy the third 
position. 1 refers to mandatory file and record locking. This permission 
describes a file's ability to allow other files to lock its reading or writing per- 
missions during access. 

For others permissions, the third position may be occupied by t or T. These 
refer to the state of the sticky bit and execution permissions. 

EXAMPLES 

An example of a file's permissions is: 

-rwxr — r — 

This describes a file that is readable, writable, and executable by the user 
and readable by the group and others. 

Another example of a file's permissions is: 

-rwsr-xr-x 

This describes a file that is readable, writable, and executable by the user, 
readable and executable by the group and others, and allows its user-ID to 

- 3 - 



LS(1) 



(Base System) 



LS(1) 



be assumed, during execution, by the user presently executing it. 
Another example of a file's permissions is: 
-rw-rwl 

This describes a file that is readable and writable only by the user and the 
group and can be locked during access. 

An example of a command line: 

Is -a 

This command will print the names of all files in the current directory, 
including those that begin with a dot (.), which normally do not print. 

Another example of a command line: 

Is -aisn 

This command will provide you with quite a bit of information including all 
files, including non-printing ones (a), the i-number — the memory address of 
the inode associated with the file — printed in the left-hand column (i); the 
size (in blocks) of the files, printed in the column to the right of the i- 
numbers (s); finally, the report is displayed in the numeric version of the 
long list, printing the UID (instead of user name) and GID (instead of group 
name) numbers associated with the files. 

When the sizes of the files in a directory are listed, a total count of blocks, 
including indirect blocks, is printed. 

FILES 

/etc/passwd user IDs for Is -1 and Is -o 

/etc/group group IDs for Is -1 and Is -g 

/usr/lib/terminfo/?/* terminal information database 

SEE ALSO 

chmod(l), find(l). 

NOTES 

In a Remote File Sharing environment, you may not have the permissions 
that the output of the Is -1 command leads you to believe. For more infor- 
mation see the "Mapping Remote Users" section of Chapter 10 of the 
Operations /System Administration Guide, 

BUGS 

Unprintable characters in file names may confuse the columnar output 
options. 
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NAME 

machid: i386 - get processor type truth value 

SYNOPSIS 
i386 

DESCRIPTION 

The following commands will return a true value (exit code of 0). 

The commands that do not apply will return a false (non-zero) value. 
These commands are often used within makefiles [see make(l)] and shell 
procedures [see sh(l)] to increase portability. 

SEE ALSO 

sh(l), test(l), true(l). 

make(l) in the Programmer's Reference Manual. 
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NAME 

mail, rmail - send mail to users or read mail 

SYNOPSIS 

Sending mail: 

mail [ -wt ] persons 
rmail [ -wt ] persons 
Reading mail: 

mail [ -ehpqr ] [ -f file ] [ -F persons ] 

DESCRIPTION 

Sending mail: 

The command-line options that follow affect SENDING mail: 

-w causes a letter to be sent to a remote user without waiting for the 
completion of the remote transfer program. 

-t causes a To: line to be added to the letter, showing the intended 
recipients. 

A person is usually a user name recognized by login (I). When persons are 
named, mail assumes a message is being sent (except in the case of the -F 
option). It reads from the standard input up to an end-of-file (control-d), or 
until it reads a line consisting of just a period. When either of those signals 
is received, mail adds the letter to the mailfile for each person. A letter is a 
message preceded by a postmark. The message is preceded by the sender's 
name and a postmark. A postmark consists of one or more 'From' lines fol- 
lowed by a blank line. 

If a letter is found to be undeliverable, it is returned to the sender with 
diagnostics that indicate the location and nature of the failure. If mail is 
interrupted during input, the file dead.letter is saved to allow editing and 
resending. dead.letter is recreated every time it is needed, erasing any pre- 
vious contents. 

rmail only permits the sending of mail; uucp{\C) uses rmail as a security 
precaution. 

If the local system has the Basic Networking Utilities installed, mail may be 
sent to a recipient on a remote system. Prefix person by the system name 
and exclamation point. A series of system names separated by exclamation 
points can be used to direct a letter through an extended network. 

Reading Mail: 

The command-line options that follow affect READING mail: 

-e causes mail not to be printed. An exit value of is returned if the 
user has mail; otherwise, an exit value of 1 is returned. 

-h causes a window of headers to be displayed rather than the latest 
message. The display is followed by the ? prompt. 

-p causes all messages to be printed without prompting for disposition. 

-q causes mail to terminate after interrupts. Normally an interrupt 
causes only the termination of the message being printed. 
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-r causes messages to be printed in first-in, first-out order. 

'{file causes mail to use file (e.g., mbox) instead of the default mailfile. 

-Fpersons 

entered into an empty mailbox, causes all incoming mail to be for- 
warded to persons. 

mail , unless otherwise influenced by command-line options, prints a user's 
mail messages in last-in, first-out order. For each message, the user is 
prompted with a ?, and a line is read from the standard input. The follow- 
ing commands are available to determine the disposition of the message: 



<new-line>, +, or n Go on to next message. 

d or dp Delete message and go on to next message. 

d # Delete message number #. Do not go on to next 

message. 

dq Delete message and quit mail. 

h Display a window of headers around current mes- 

sage. 

h # Display header of message number #. 

h a Display headers of ALL messages in the user's mail- 

file. 

h d Display headers of messages scheduled for deletion, 

p Print current message again. 

Print previous message, 
a Print message that arrived during the mail session. 

# Print message number #. 

r [ users ] Reply to the sender, and other user(s), then delete 

the message. 

s [ files ] Save message in the named files (mbox is default), 

y Same as save. 

u [ # ] Undelete message number # (default is last read). 

w [ files ] Save message, without its top-most header, in the 

named files (mbox is default). 

m [ persons ] Mail the message to the named persons. 

q, or ctl-d Put undeleted mail back in the mailfile and quit 

mail. 

X Put all mail back in the mailfile unchanged and exit 

mail. 

\command Escape to the shell to do command. 

? Print a command summary. 



When a user logs in, the presence of mail, if any, is indicated. Also, notifi- 
cation is made if new mail arrives while using mail. 
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The mailfile may be manipulated in two ways to alter the function of mail. 
The other permissions of the file may be read-write, read-only, or neither 
read nor write to allow different levels of privacy. If changed to other than 
the default, the file will be preserved even when empty to perpetuate the 
desired permissions. The file may also contain the first line: 

Forward to person 

which will cause all mail sent to the owner of the mailfile to be forwarded 
to person . A " Forwarded by ... " message is added to the header. This is 
especially useful in a multi-machine environment to forward all of a 
person's mail to a single machine and to keep the recipient informed if the 
mail has been forwarded. Installation and removal of forwarding is done 
with the -F option. 

To forward all of one's mail to systemaluser enter: 
mail -Fsystemaluser 

To forward to more than one user enter: 

mail -F"userl,systema!user2,systema!systemb!user3 " 

Note that when more than one user is specified, the whole list should be 
enclosed in double quotes so that it may all be interpreted as the operand of 
the -F option. The list can be up to 1024 bytes; either commas or white 
space can be used to separate users. 

The following list of characters are prohibited from appearing anywhere in 
the mail -F argument list or in the " Forward to " line: 
; 5c I A < > . ( ) <CR> 

To remove forwarding enter: 
mail -F " " 



FILES 



The pair of double quotes is mandatory to set a NULL argument for the -F 
option. 

For forwarding to work properly, the mailfile should have "mail" as group 
ID, and the group permission should be read-write. 



/etc/passwd 

/ USX /mail /user 

$HOME/mbox 

$MAIL 

/tmp/ma* 

/usr/mail/*.lock 

dead.letter 



to identify sender and locate persons 
incoming mail for user; i.e., the mailfile 
saved mail 

variable containing path name of mailfile 

temporary file 

lock for mail directory 

unmailable text 



SEE ALSO 

login(l), mailx(l), write(l). 

Operations /System Administration Guide. 
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WARNINGS 

The "Forward to person" feature may result in a loop if sysHuserb forwards 
to sysHuserb and sysHuserb forwards to sysHuserb. The symptom is a mes- 
sage saying "unbounded . . . saved mail in dead.letter. " 



BUGS 



Conditions sometimes result in a failure to remove a lock file. 

After an interrupt, the next message may not be printed; printing may be 

forced by typing a p. 
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NAME 

mailx - interactive message processing system 

SYNOPSIS 

mailx [options] [name...] 

DESCRIPTION 

The command mailx provides a comfortable, flexible environment for send- 
ing and receiving messages electronically. When reading mail, mailx pro- 
vides commands to facilitate saving, deleting, and responding to messages. 
When sending mail, mailx allows editing, reviewing, and other modification 
of the message as it is entered. 

Many of the remote features of mailx will only work if the Basic Networking 
Utilities are installed on your system. 

Incoming mail is stored in a standard file for each user, called the mailbox 
for that user. When mailx is called to read messages, the mailbox is the 
default place to find them. As messages are read, they are marked to be 
moved to a secondary file for storage, unless specific action is taken, so that 
the messages need not be seen again. This secondary file is called the 
mbox and is normally located in the user's HOME directory [see MBOX 
(ENVIRONMENT VARIABLES) for a description of this file]. Messages can be 
saved in other secondary files named by the user. Messages remain in a 
secondary file until forcibly removed. 

The user can access a secondary file by using the -f option of the mailx 
command. Messages in the secondary file can then be read or otherwise 
processed using the same COMMANDS as in the primary mailbox. This 
gives rise within these pages to the notion of a current mailbox. 

On the command line, options start with a dash (-) and any other arguments 
are taken to be destinations (recipients). If no recipients are specified, mailx 
will attempt to read messages from the mailbox. Command line options 
are: 

-e Test for presence of mail, mailx prints nothing and 

exits with a successful return code if there is mail to 
read. 

-f [filename] Read messages from filename instead of mailbox. If 
no filename is specified, the mbox is used. 

-F Record the message in a file named after the first 

recipient. Overrides the "record" variable, if set 
(see ENVIRONMENT VARIABLES). 

-h number The number of network "hops" made so far. This 
is provided for network software to avoid infinite 
delivery loops. (See addsopt under ENVIRONMENT 
VARIABLES). 

-H Print header summary only. 

-i Ignore interrupts. See also ignore (ENVIRONMENT 

VARIABLES). 

-n Do not initialize from the system default mailx.rc 

file. 
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-N Do not print initial header summary. 

-r address Pass address to network delivery software. All tilde 

commands are disabled. (See addsopt under 

ENVIRONMENT VARIABLES), 
-s subject Set the Subject header field to subject, 
-u user Read user's mailbox. This is only effective if user's 

mailbox is not read protected. 
-U Convert uucp style addresses to internet standards. 

Overrides the conv environment variable. (See 

addsopt under ENVIRONMENT VARIABLES). 

When reading mail, mailx is in command mode. A header summary of the 
first several messages is displayed, followed by a prompt indicating mailx 
can accept regular commands (see COMMANDS below). When sending mail, 
mailx is in input mode. If no subject is specified on the command line, a 
prompt for the subject is printed. (A "subject" longer than 1024 characters 
will cause mailx to dump core.) As the message is typed, mailx will read the 
message and store it in a temporary file. Commands may be entered by 
beginning a line with the tilde (") escape character followed by a single 
command letter and optional arguments. See TILDE ESCAPES for a summary 
of these commands. 

At any time, the behavior of mailx is governed by a set of environment vari- 
ables. These are flags and valued parameters which are set and cleared via 
the set and unset commands. See ENVIRONMENT VARIABLES below for a 
summary of these parameters. 

Recipients listed on the command line may be of three types: login names, 
shell commands, or alias groups. Login names may be any network 
address, including mixed network addressing. If mail is found to to 
undeliverable, an attempt is made to return it to the sender's mailbox. If the 
recipient name begins with a pipe symbol ( I ), the rest of the name is taken 
to be a shell command to pipe the message through. This provides an 
automatic interface with any program that reads the standard input, such as 
lp(l), for recording outgoing mail on paper. Alias groups are set by the 
alias command (see COMMANDS below) and are lists of recipients of any 
type. 

Regular commands are of the form 

[ command ] [ msglist ] [ arguments ] 

If no command is specified in command mode, print is assumed. In input 
mode, commands are recognized by the escape character, and lines not 
treated as commands are taken as input for the message. 
Each message is assigned a sequential number, and there is at any time the 
notion of a current message, marked by a right angle bracket (>) in the 
header summary. Many commands take an optional list of messages 
{msglist) to operate on. The default for msglist is the current message. A 
msglist is a list of message identifiers separated by spaces, which may 
include: 
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n 


Message number n. 




The current message. 




The first undeleted message. 


$ 


The last message. 


* 


All messages. 


n-m 


An inclusive range of message numbers. 


user 


All messages from user. 


/string 


All messages with string in the subject line (case ignored). 


:c 


All messages of type c, where c is one of: 



d deleted messages 

n new messages 

o old messages 

r read messages 

u unread messages 

Note that the context of the command determines whether this type 
of message specification makes sense. 

Other arguments are usually arbitrary strings whose usage depends on the 
command involved. File names, where expected, are expanded via the nor- 
mal shell conventions [see sh(l)]. Special characters are recognized by cer- 
tain commands and are documented with the commands below. 

At start-up time, mailx tries to execute commands from the optional 
system-wide file (/usr/lib/mailx/mailx.rc) to initialize certain parameters, 
then from a private start-up file ($HOME/.mailrc) for personalized vari- 
ables. With the exceptions noted below, regular commands are legal inside 
start-up files. The most common use of a start-up file is to set up initial 
display options and alias lists. The following commands are not legal in the 
start-up file: !, Copy, edit, followup, Followup, hold, mail, preserve, reply, 
Reply, shell, and visual. An error in the start-up file causes the remaining 
lines in the file to be ignored. The .mailrc file is optional and must be con- 
structed locally. 

COMMANDS 

The following is a complete list of mailx commands: 
Ishell-command 

Escape to the shell. See SHELL (ENVIRONMENT VARIABLES). 
# comment 

Null command (comment). This may be useful in .mailrc files. 
Print the current message number. 

7 

Prints a summary of commands. 
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alias alias name ... 

group alias name ... 

Declare an alias for the given names. The names will be substituted 
when alias is used as a recipient. Useful in the .mailrc file. 

alternates name ... 

Declares a list of alternate names for your login. When responding 
to a message, these names are removed from the list of recipients 
for the response. With no arguments, alternates prints the current 
list of alternate names. See also allnet (ENVIRONMENT VARIABLES). 

cd [directory] 
chdir [directory] 

Change directory. If directory is not specified, $HOME is used. 

copy [filename] 

copy [msglist] filename 

Copy messages to the file without marking the messages as saved. 

Otherwise equivalent to the save command. 

Copy [msglist] 

Save the specified messages in a file whose name is derived from 
the author of the message to be saved, without marking the mes- 
sages as saved. Otherwise equivalent to the Save command. 

delete [msglist] 

Delete messages from the mailbox. If autoprint is set, the next 
message after the last one deleted is printed (see ENVIRONMENT 
VARIABLES). 

discard [header-field ...] 

ignore [header-field ...] 

Suppresses printing of the specified header fields when displaying 
messages on the screen. Examples of header fields to ignore are 
"status" and "cc." The fields are included when the message is 
saved. The Print and Type commands override this command. 

dp [msglist] 
dt [msglist] 

Delete the specified messages from the mailbox and print the next 
message after the last one deleted. Roughly equivalent to a delete 
command followed by a print command. 

echo string ... 

Echo the given strings [like echo (I)]. 

edit [msglist] 

Edit the given messages. The messages are placed in a temporary 
file and the EDITOR variable is used to get the name of the editor 
(see ENVIRONMENT VARIABLES). Default editor is ed{l). 
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exit 
xit 

Exit from mailx without changing the mailbox. No messages are 
saved in the mbox (see also quit). 

file {filename] 
folder [filename] 

Quit from the current file of messages and read in the specified file. 
Several special characters are recognized when used as file names, 
with the following substitutions: 

% the current mailbox. 
%user 

the mailbox for user. 

# the previous file. 
& the current mbox. 

Default file is the current mailbox, 
folders 

Print the names of the files in the directory set by the folder vari- 
able (see ENVIRONMENT VARIABLES). 

followup [message] 

Respond to a message, recording the response in a file whose name 
is derived from the author of the message. Overrides the record 
variable, if set. See also the Followup, Save, and Copy commands 
and outfolder (ENVIRONMENT VARIABLES). 

Followup [msglist] 

Respond to the first message in the msglist, sending the message to 
the author of each message in the msglist. The subject line is taken 
from the first message and the response is recorded in a file whose 
name is derived from the author of the first message. See also the 
followup. Save, and Copy commands and "outfolder" (ENVIRON- 
MENT VARIABLES). 

from [msglist] 

Prints the header summary for the specified messages. 

group alias name ... 

alias alias name ... 

Declare an alias for the given names. The names will be substituted 
when alias is used as a recipient. Useful in the .mailrc file. 

headers [message] 

Prints the page of headers which includes the message specified. 
The screen variable sets the number of headers per page (see 
ENVIRONMENT VARIABLES). See also the z command. 
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help 

Prints a summary of commands. 

hold [msglist] 
preserve [msglist] 

Holds the specified messages in the mailbox. 

if si r 
s 

else 

s 

endif 

Conditional execution, where s will execute following s, up to an 
else or endif, if the program is in send mode, and r causes the s to 
be executed only in receive mode. Useful in the .mailrc file. 

ignore header-field ... 

discard header-field ... 

Suppresses printing of the specified header fields when displaying 
messages on the screen. Examples of header fields to ignore are 
"status" and "cc." All fields are included when the message is 
saved. The Print and Type commands override this command. 

list 

Prints all commands available. No explanation is given. 

mail name ... 

Mail a message to the specified users. 

Mail name 

Mail a message to the specified user and record a copy of it in a file 
named after that user. 

mbox [msglist] 

Arrange for the given messages to end up in the standard mbox 
save file when mailx terminates normally. See MBOX (ENVIRON- 
MENT VARIABLES) for a description of this file. See also the exit 
and quit commands. 

next [message] 

Go to next message matching message. A msglist may be specified, 
but in this case the first valid message in the list is the only one 
used. This is useful for jumping to the next message from a specific 
user, since the name would be taken as a command in the absence 
of a real command. See the discussion of msglists above for a 
description of possible message specifications. 
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pipe [msglist] [shell-command] 

I [msglist] [shell-command] 

Pipe the message through the given shell-command. The message is 
treated as if it were read. If no arguments are given, the current 
message is piped through the command specified by the value of 
the cmd variable. If the page variable is set, a form feed character 
is inserted after each message (see ENVIRONMENT VARIABLES). 

preserve [msglist] 
hold [msglist] 

Preserve the specified messages in the mailbox. 

Print [msglist] 
Type [msglist] 

Print the specified messages on the screen, including all header 
fields. Overrides suppression of fields by the ignore command. 

print [msglist] 
type [msglist] 

Print the specified messages. If crt is set, the messages longer than 
the number of lines specified by the crt variable are paged through 
the command specified by the PAGER variable. The default com- 
mand is pg{l) (see ENVIRONMENT VARIABLES). 

quit 

Exit from mailx, storing messages that were read in mbox and 
unread messages in the mailbox. Messages that have been expli- 
citly saved in a file are deleted. 

Reply [msglist] 

Respond [msglist] 

Send a response to the author of each message in the msglist. The 
subject line is taken from the first message. If record is set to a file 
name, the response is saved at the end of that file (see ENVIRON- 
MENT VARIABLES). 

reply [message] 

respond [message] 

Reply to the specified message, including all other recipients of the 
message. If record is set to a file name, the response is saved at the 
end of that file (see ENVIRONMENT VARIABLES). 

Save [msglist] 

Save the specified messages in a file whose name is derived from 
the author of the first message. The name of the file is taken to be 
the author's name with all network addressing stripped off. See 
also the Copy, followup, and Followup commands and outfolder 
(ENVIRONMENT VARIABLES). 
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save [filename] 

save [msglist] filename 

Save the specified messages in the given file. The file is created if it 
does not exist. The message is deleted from the mailbox when 
mailx terminates unless keepsave is set (see also ENVIRONMENT 
VARIABLES and the exit and quit commands). 

set 

set name 

set name=string 

set name^number 

Define a variable called name. The variable may be given a null, 
string, or numeric value. Set by itself prints all defined variables 
and their values. See ENVIRONMENT VARIABLES for detailed 
descriptions of the mailx variables. 

shell 

Invoke an interactive shell [see also SHELL (ENVIRONMENT VARI- 
ABLES)]. 

size [msglist] 

Print the size in characters of the specified messages, 
source filename 

Read commands from the given file and return to command mode, 
top [msglist] 

Print the top fev^ lines of the specified messages. If the toplines 
variable is set, it is taken as the number of lines to print (see 
ENVIRONMENT VARIABLES). The default is 5. 

touch [msglist] 

Touch the specified messages. If any message in msglist is not 
specifically saved in a file, it will be placed in the mbox, or the file 
specified in the MBOX environment variable, upon normal termina- 
tion. See exit and quit. 

Type [msglist] 
Print [msglist] 

Print the specified messages on the screen, including all header 
fields. Overrides suppression of fields by the ignore command. 

type [msglist] 
print [msglist] 

Print the specified messages. If crt is set, the messages longer than 
the number of lines specified by the crt variable are paged through 
the command specified by the PAGER variable. The default com- 
mand is pg(l) (see ENVIRONMENT VARIABLES). 
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undelete [msglist] 

Restore the specified deleted messages. Will only restore messages 
deleted in the current mail session. If autoprint is set, the last mes- 
sage of those restored is printed (see ENVIRONMENT VARIABLES). 

unset name ... 

Causes the specified variables to be erased. If the variable was 
imported from the execution environment (i.e., a shell variable), 
then it cannot be erased. 

version 

Prints the current version and release date, 
visual [msglist] 

Edit the given messages with a screen editor. The messages are 
placed in a temporary file and the VISUAL variable is used to get 
the name of the editor (see ENVIRONMENT VARIABLES). 

write [msglist] filename 

Write the given messages on the specified file, minus the header 
and trailing blank line. Otherwise equivalent to the save command. 

xit 
exit 

Exit from mailx, without changing the mailbox. No messages are 
saved in the mbox (see also quit). 

z[+ I -] 

Scroll the header display forward or backward one full screen. The 
number of headers displayed is set by the screen variable (see 
ENVIRONMENT VARIABLES). 

TILDE ESCAPES 

The following commands may be entered only from input mode, by begin- 
ning a line with the tilde escape character ("). See escape (ENVIRONMENT 
VARIABLES) for changing this special character. 

"! shell-command 

Escape to the shell. 



Simulate end of file (terminate message input). 



Perform the command-level request. Valid only when sending a 
message while reading mail. 

"? 

Print a summary of tilde escapes. 
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-A 

Insert the autograph string Sign into the message (see ENVIRON- 
MENT VARIABLES). 

'a 

Insert the autograph string sign into the message (see ENVIRON- 
MENT VARIABLES). 

'b name ... 

Add the names to the blind carbon copy (Bcc) list, 
'c name ... 

Add the names to the carbon copy (Cc) list. 

~d 

Read in the dead.letter file. See DEAD (ENVIRONMENT VARIABLES) 
for a description of this file. 

'e 

Invoke the editor on the partial message. See also EDITOR 
(ENVIRONMENT VARIABLES). 

'f [msglist] 

Forward the specified messages. The messages are inserted into the 
message without alteration. 

-h 

Prompt for Subject line and To, Cc, and Bcc lists. If the field is 
displayed with an initial value, it may be edited as if you had just 
typed it. 

"i string 

Insert the value of the named variable into the text of the message. 
For example, 'A is equivalent to '"i Sign.' Environment variables set 
and exported in the shell are also accessible by 'i. 

"m [msglist] 

Insert the specified messages into the letter, shifting the new text to 
the right one tab stop. Valid only when sending a message while 
reading mail. 

"P 

Print the message being entered. 

Quit from input mode by simulating an interrupt. If the body of the 
message is not null, the partial message is saved in dead.letter. See 
DEAD (ENVIRONMENT VARIABLES) for a description of this file. 
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filename 
filename 
Ishell-command 

Read in the specified file. If the argument begins with an exclama- 
tion point (!), the rest of the string is taken as an arbitrary shell 
command and is executed, with the standard output inserted into 
the message. 

"s string ... 

Set the subject line to string. 

"t name ... 

Add the given names to the To list. 

"v 

Invoke a preferred screen editor on the partial message. See also 
VISUAL (ENVIRONMENT VARIABLES). 

"w filename 

Write the partial message onto the given file, without the header. 

Exit as with ~q except the message is not saved in dead.letter. 
"i shell-command 

Pipe the body of the message through the given shell-command. If 
the shell-command returns a successful exit status, the output of the 
command replaces the message. 

ENVIRONMENT VARIABLES 

The following are environment variables taken from the execution environ- 
ment and are not alterable within mailx. 

HOME=directory 

The user's base of operations. 

MAlLRC=filename 

The name of the start-up file. Default is $HOME/.mailrc. 

The following variables are internal mailx variables. They may be imported 
from the execution environment or set via the set command at any time. 
The unset command may be used to erase variables. 

addsopt 

Enabled by default. If /bin/mail is not being used as the deliverer, 
noaddsopt should be specified. (See WARNINGS below) 
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allnet 

All network names whose last component (login name) match are 
treated as identical. This causes the msglist message specifications 
to behave similarly. Default is noallnet. See also the alternates 
command and the metoo variable. 

append 

Upon termination, append messages to the end of the mbox file 
instead of prepending them. Default is noappend. 

askcc 

Prompt for the Cc list after message is entered. Default is noaskcc. 

asksub 

Prompt for subject if it is not specified on the command line with 
the -s option. Enabled by default. 

autoprint 

Enable automatic printing of messages after delete and undelete 
commands. Default is noautoprint. 

bang 

Enable the special-casing of exclamation points (!) in shell escape 
command lines as in vi(l). Default is nobang. 

cmd=shell-command 

Set the default command for the pipe command. No default value. 

cony=conversion 

Convert uucp addresses to the specified address style. The only 
valid conversion now is internet, which requires a mail delivery pro- 
gram conforming to the RFC822 standard for electronic mail 
addressing. Conversion is disabled by default. See also sendmail 
and the -U command line option. 

cri=number 

Pipe messages having more than number lines through the com- 
mand specified by the value of the PAGER variable [pg(l) by 
default]. Disabled by default. 

DEAD=filename 

The name of the file in which to save partial letters in case of 
untimely interrupt. Default is $HOME/dead.letter. 

debug 

Enable verbose diagnostics for debugging. Messages are not 
delivered. Default is nodebug. 
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dot 

Take a period on a line by itself during input from a terminal as 
end-of-file. Default is nodot. 

EDnOR=shell-command 

The command to run when the edit or command is used. Default 
is ed{l). 

escape=c 

Substitute c for the " escape character. Takes effect with next mes- 
sage sent. 

folder=directory 

The directory for saving standard mail files. User-specified file 
names beginning with a plus (+) are expanded by preceding the file 
name with this directory name to obtain the real file name. If direc- 
tory does not start with a slash (/), $HOME is prepended to it. In 
order to use the plus (+) construct on a mailx command line, folder 
must be an exported sh environment variable. There is no default 
for the folder variable. See also outfolder below. 

header 

Enable printing of the header summary when entering mailx. 
Enabled by default. 

hold 

Preserve all messages that are read in the mailbox instead of put- 
ting them in the standard mbox save file. Default is nohold. 

ignore 

Ignore interrupts while entering messages. Handy for noisy dial-up 
lines. Default is noignore. 

ignoreeof 

Ignore end-of-file during message input. Input must be terminated 
by a period (.) on a line by itself or by the command. Default is 
noignoreeof. See also dot above, 

keep 

When the mailbox is empty, truncate it to zero length instead of 
removing it. Disabled by default. 

keepsave 

Keep messages that have been saved in other files in the mailbox 
instead of deleting them. Default is nokeepsave. 

MBOX=filename 

The name of the file to save messages which have been read. The 
xit command overrides this function, as does saving the message 
explicitly in another file. Default is $HOME/mbox. 
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metoo 

If your login appears as a recipient, do not delete it from the list. 
Default is nometoo. 

LlSTER=shell-command 

The comnnand (and options) to use when listing the contents of the 
folder directory. The default is ls(l). 

onehop 

When responding to a message that was originally sent to several 
recipients, the other recipient addresses are normally forced to be 
relative to the originating author's machine for the response. This 
flag disables alteration of the recipients' addresses, improving effi- 
ciency in a network where all machines can send directly to all 
other machines (i.e., one hop away). 

outfolder 

Causes the files used to record outgoing messages to be located in 
the directory specified by the folder variable unless the path name 
is absolute. Default is nooutfolder. See folder above and the Save, 
Copy, foUowup, and Folio wup commands. 

page 

Used with the pipe command to insert a form feed after each mes- 
sage sent through the pipe. Default is nopage. 

FAGER=shell-command 

The command to use as a filter for paginating output. This can also 
be used to specify the options to be used. Default is pg{l). 

pTompi=string 

Set the command mode prompt to string. Default is ? . 

quiet 

Refrain from printing the opening message and version when enter- 
ing mailx. Default is noquiet. 

record=filename 

Record all outgoing mail in filename. Disabled by default. See also 
outfolder above. 

save 

Enable saving of messages in dead.letter on interrupt or delivery 
error. See DEAD for a description of this file. Enabled by default. 

screen=number 

Sets the number of lines in a full screen of headers for the headers 
command. 
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sendmail=shell-command 

Alternate command for delivering messages. Default is 
/bin/rmail(l). 

sendwait 

Wait for background mailer to finish before returning. Default is 
nosendwait. 

SllELL=shell-command 

The name of a preferred command interpreter. Default is sh(l). 

showto 

When displaying the header summary and the message is from you, 
print the recipient's name instead of the author's name. 

sign=string 

The variable inserted into the text of a message when the ""a (auto- 
graph) command is given. No default [see also ""i (TILDE ESCAPES)]. 

Sign=string 

The variable inserted into the text of a message when the ""A com- 
mand is given. No default [see also (TILDE ESCAPES)]. 

toplines=number 

The number of lines of header to print with the top command. 
Default is 5. 

yiSlJAL=shell-command 

The name of a preferred screen editor. Default is vi(l). 



SEE ALSO 

ls(l), mail(l), pg(l). 

WARNINGS 

The -h, -r and -U options can be used only if mailx is built with a delivery 
program other than /bin /mail. 

BUGS 

Where shell-command is shown as valid, arguments are not always allowed. 
Experimentation is recommended. 

Internal variables imported from the execution environment cannot be 



FILES 



$HOME/.mailrc 

$HOME/mbox 

/usr/mail/* 

/usr /lib /mailx /mailx.help* 

/usr/lib/mailx/mailx.rc 

/tmp/R[emqsx]* 



personal start-up file 
secondary storage file 
post office directory 
help message files 
optional global start-up file 
temporary files 



unset. 
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The full internet addressing is not fully supported by mailx. The new stan- 
dards need some time to settle down. 

Attempts to send a message having a line consisting only of a are 
treated as the end of the message by mail{l) (the standard mail delivery 
program). 
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NAME 

makekey - generate encryption key 

SYNOPSIS 

/usr /lib /makekey 

DESCRIPTION 

makekey improves the usefulness of encryption schemes depending on a key 
by increasing the amount of time required to search the key space. It 
attempts to read 8 bytes for its key (the first eight input bytes), then it 
attempts to read 2 bytes for its salt (the last two input bytes). The output 
depends on the input in a way intended to be difficult to compute (i.e., to 
require a substantial fraction of a second). 

The first eight input bytes (the input key) can be arbitrary ASCII characters. 
The last two (the salt) are best chosen from the set of digits, ., /, and upper- 
and lower-case letters. The salt characters are repeated as the first two 
characters of the output. The remaining 11 output characters are chosen 
from the same set as the salt and constitute the output key. 

The transformation performed is essentially the following: the salt is used 
to select one of 4,096 cryptographic machines all based on the National 
Bureau of Standards DBS algorithm, but broken in 4,096 different ways. 
Using the input key as key, a constant string is fed into the machine and 
recirculated a number of times. The 64 bits that come out are distributed 
into the 66 output key bits in the result. 

makekey is intended for programs that perform encryption. Usually, its 
input and output will be pipes. 

SEE ALSO 

ed(l), crypt(l), vi(l). 

passwd(4) in the Programmer's Reference Manual. 
CAVEATS 

makekey can produce different results depending upon whether the input is 
typed at the terminal or redirected from a file. 

WARNING 

This command is provided with the Security Administration Utilities, which 
is only available in the United States. 
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NAME 

mesg - permit or deny messages 

SYNOPSIS 

mesg [ -n ] [ -y ] 

DESCRIPTION 

The mesg command with argument n forbids messages via write (I) by 
revoking non-user write permission on the user's terminal. The mesg com- 
mand with argument y reinstates permission. All by itself, mesg reports the 
current state without changing it. 

FILES 

/dev/tty* 

SEE ALSO 

write(l). 

DIAGNOSTICS 

Exit status is if messages are receivable, 1 if not, 2 on error. 
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NAME 

mkdir - make directories 

SYNOPSIS 

mkdir [ -m mode ] [ -p] dirname ... 

DESCRIPTION 

The mkdir command creates the named directories in mode 777 [possibly 
altered by umask{l)]. 

Standard entries in a directory (e.g., the files for the directory itself, and .., 
for its parent) are made automatically, mkdir cannot create these entries by 
name. Creation of a directory requires write permission in the parent direc- 
tory. 

The owner ID and group ID of the new directories are set to the process's 
real user ID and group ID, respectively. 

Two options apply to mkdir: 

-m This option allows users to specify the mode to be used for new direc- 
tories. Choices for modes can be found in chmod(l). 

-p With this option, mkdir creates dirname by creating all the non-existing 
parent directories first. 

EXAMPLE 

To create the subdirectory structure Itr/jd/jan, type: 
mkdir -p Itr/jd/jan 

SEE ALSO 

sh(l), rm(l), umask(l). 

intro(2), mkdir(2) in the Programmer's Reference Manual . 
DIAGNOSTICS 

The mkdir command returns exit code if all directories given in the com- 
mand line were made successfully. Otherwise, it prints a diagnostic and 
returns non-zero. An error code is stored in errno . 
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NAME 

mkfs - construct a file system 
SYNOPSIS 

/etc/mkfs special blocks[:inodes] [gap blocks/cyl] [-b blocksize] 
/etc/mkfs special proto [gap blocks/cyl] [-b blocksize] 

DESCRIPTION 

mkfs constructs a file system by writing on the special file using the values 
found in the remaining arguments of the command line. The command 
waits 10 seconds before starting to construct the file system. During this 
10-second pause the command can be aborted by entering a delete (DEL). 

The -b blocksize option specifies the logical block size for the file system. 
The logical block size is the number of bytes read or written by the operat- 
ing system in a single I/O operation. Valid values for blocksize are 512, 
1024, and 2048. The default is 1024. A block size of 2048 may be chosen 
only if the 2K file system package is installed. If the -b option is used, it 
must appear last on the command line. 

If the second argument to mkfs is a string of digits, the size of the file sys- 
tem is the value of blocks interpreted as a decimal number. This is the 
number of physical (512-byte) disk blocks the file system will occupy. If the 
number of inodes is not given, the default is approximately the number of 
logical blocks divided by 4. mkfs builds a file system with a single empty 
directory on it. The boot program block (block zero) is left uninitialized. 
If the second argument is the name of a file that can be opened, mkfs 
assumes it to be a prototype file proto, and will take its directions from that 
file. The prototype file contains tokens separated by spaces or new-lines. A 
sample prototype specification follows (line numbers have been added to 
aid in the explanation): 



1. 


/stand/ diskboot 


2. 


4872 110 




3. 


d— 777 3 1 




4. 


usr d — 


777 3 1 


5. 


sh 


755 3 1 /bin/sh 


6. 


ken 


d--755 6 1 


7. 




$ 


8. 


bO 


b— 644 3 1 


9. 


cO 


c— 644 3 1 


10. 


$ 




11. 


$ 





Line 1 in the example is the name of a file to be copied onto block zero as 
the bootstrap program. 

Line 2 specifies the number of physical (512-byte) blocks the file system is 
to occupy and the number of inodes in the file system. 

Lines 3-9 tell mkfs about files and directories to be included in this file sys- 
tem. 



- 1 - 



MKFS(IM) 



(2K File System) 



MKFS(IM) 



Line 3 specifies the root directory. 

Lines 4-6 and 8-9 specify other directories and files. 

The $ on line 7 tells mkfs to end the branch of the file system it is on, and 
continue from the next higher directory. The $ on lines 10 and 11 end the 
process, since no additional specifications follow. 

File specifications give the mode, the user ID, the group ID, and the initial 
contents of the file. Valid syntax for the contents field depends on the first 
character of the mode. 

The mode for a file is specified by a 6-character string. The first character 
specifies the type of the file. The character range is -bed to specify regular, 
block special, character special and directory files, respectively. The second 
character of the mode is either u or - to specify set-user-id mode or not. 
The third is g or - for the set-group-id mode. The rest of the mode is a 
3-digit octal number giving the owner, group, and other read, write, execute 
permissions [see chmod{l)]. 

Two decimal number tokens come after the mode; they specify the user and 
group IDs of the owner of the file. 

If the file is a regular file, the next token of the specification may be a path 
name from which the contents and size are copied. If the file is a block or 
character special file, two decimal numbers follow which give the major and 
minor device numbers. If the file is a directory, mkfs makes the entries . 
and .. and then reads a list of names and (recursively) file specifications for 
the entries in the directory. As noted above, the scan is terminated with the 
token $. 

The gap blocks /cyl argument in both forms of the command specifies the 
rotational gap and the number of blocks/cylinder. 

FILES 

/etc/vtoc/* 

SEE ALSO 

chmod(l). 

dir(4), fs(4) in the Programmer's Reference Manual. 

BUGS 

With a prototype file, it is not possible to copy in a file larger than 64K 
bytes, nor is there a way to specify links. The maximum number of inodes 
configurable is 65500. 
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NAME 

mknod - build special file 

SYNOPSIS 

/etc/mknod name b | c major minor 
/etc/mknod name p 

DESCRIPTION 

The mknod command makes a directory entry and corresponding inode for a 
special file. 

The first argument is the name of the entry. The UNIX System convention is 
to keep such files in the /dev directory. 

In the first case, the second argument is b if the special file is block-type 
(disks, tape) or c if it is character-type (other devices). The last two argu- 
ments are numbers specifying the major device type and the minor device 
(e.g., unit, drive, or line number). They may be either decimal or octal. The 
assignment of major device numbers is specific to each system. The infor- 
mation is contained in the system source file conf.c. You must be the 
super-user to use this form of the command. 

The second case is the form of the mknod that is used to create FIFO's (a.k.a 
named pipes). 

WARNING 

If mknod is used to create a device in a remote directory (Remote File Shar- 
ing), the major and minor device numbers are interpreted by the server. 

SEE ALSO 

mknod(2) in the Programmer's Reference Manual, 
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NAME 

mkpart - disk maintenance utility 
SYNOPSIS 

/etc/mkpart [ -f filename ] [ -p partition ]...[-? partition ] . . . [ -b ] 
[ -B filename ] [ -A sector ] ... [ -V ] [ -v ] [ -i ] [ -x file ] 
[ -t [ vpa ] ] device 

/etc/mkpart -F interleave raw_device 

DESCRIPTION 

This program allows the system administrator to display and modify the 
data structures that the disk driver uses to access disks. These structures 
describe the number, size, and type of the partitions, as well as the physical 
characteristics of the disk drive itself. 

The user maintains a file of stanzas, each of which contains comments and 
parameters. The stanzas are of two varieties: those that describe disk parti- 
tions and disk devices. Stanzas may refer to other stanzas of the same type 
so that common device or partition types may be customized. By default, 
the stanza file is named /etc/partitions. The required parameter, device, 
specifies the device stanza for the disk to be used. 

The following options may be used with mkpart: 

-f filename 

specifies the partition and device specification stanza file. If not 
present, /etc/partitions is assumed. 

-p partition 

removes a partition from the vtoc on the specified device. The par- 
tition is a stanza that indicates the partition to be removed by its 
partition number parameter; no comparisons are made by attribute. 
NOTE: Alternate partitions cannot be removed. 

-P partition 

adds a partition to the vtoc on the specified device, partition is a 
stanza which contains and/or refers to other stanzas that contain all 
of the necessary parameters for a vtoc partition. 

-b causes only the boot program to be updated, unless other options 
are specified. 

-B filename 

specifies a different boot program than the one given by the device 
stanza. 

-F interleave 

causes the entire device to be hardware formatted. This process re- 
writes all the sector headers on each track of the disk, enabling sub- 
sequent access using normal reads and writes, interleave is the dis- 
tance in physical sectors between each successive logical sector. 
Normal values are 1 for track-cache controllers, 3-4 for standard 
controllers. The device for this option must be a raw UNIX system 
device. The -F option precludes all other options, thus should be 
used alone. 
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-A sector 

marks the specified sector as bad and assigns it an alternate if possi- 
ble, sector is a zero-based absolute sector number from the begin- 
ning of the drive. To compute a sector number given cylinder, 
head, and (0-based) sector in track, the formula is cylinder * 
(sectors-per-track * heads-per-cylinder) + head * (sectors-per-track) 
+ sector. 

-V causes a complete surface-analysis pass to be run. This first writes a 
data pattern (currently 0xe5 in every byte) to each sector of the disk, 
then reads each sector. Any errors are noted and the bad sectors 
found are added to the alternates table if possible. 

-V causes a non-destructive surface-analysis pass to be run. This just 
reads every sector of the disk, noting bad sectors as above. 

-i initializes the VTOC on the drive to default values, clearing any 
existing partition and bad-sector information which may have 
existed. This is the only way to remove an alternate partition and 
can be used to re-initialize a drive which may have obsolete or 
incorrect VTOC data on it. 

-x file writes a complete device and partition stanza list for the specified 
device to file. Note: The tags in the file are pseudo names used to 
identify the slice. 

-t [vpa] 

creates a listing of the current vtoc. The sub-parameters specify 
pieces to be printed: a - alternate sectors, p - partitions, and v - vtoc 
and related structures. 

The partitions file is composed of blank-line-separated stanzas. (Blank lines 
have only tabs and spaces between new-lines). Commentary consists of all 
text between a and a new-line. Stanzas begin with an identifier fol- 
lowed by a ':', and are followed by a comma-separated list of parameters. 
Each parameter has a keyword followed by an followed by a value. The 
value may be a number, another stanza's name, a double quoted string, or a 
parenthesis-surrounded, comma-separated list of numbers or ranges of 
numbers, as appropriate for the keyword. Numbers may be written as 
decimal, octal, or hexadecimal constants in the form familiar to C program- 
mers. 

Device specification stanzas may contain the following parameters: 

usedevice = name 

causes the named stanza's parameters to be included in the device 
definition. 

boot = string 

indicates that the string is the filename of a bootstrap program to 
install on the disk. 

device = string 

gives the filename of the character special device for the disk. 
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heads = number 

specifies the number of tracks per cylinder on the device. 

cyls = number 

is the number of cylinders on the disk. 

sectors = number 

is the number of sectors per track. 

bpsec = number 

is the number of bytes per sector. 

dserial = string 

is an arbitrary string which is recorded in the volume label. (Mul- 
tibus systems only) 

vtocsec = number 

gives the sector number to use for the volume table of contents. 
NOTE: for AT386 systems, this number MUST be 17. 

altsec = number 

is the sector to use for the alternate block table. 

badsec = number-list 

lists the known bad sectors. These are appended to any specified in 
the command line or found during surface analysis. 

Partition stanzas may have the following parameters: 

usepart = name 

refers to another partition stanza. 

partition = number 

gives this partition's entry number in the vtoc. 

tag = tagname 

A partition tag specifies the purpose of the partition. The tagnames 
are reserved words which are presently used for identification pur- 
poses ONLY: 

BACKUP means the entire disk. 
ROOT is a root file system partition. 
BOOT is a bootstrap partition. 

SWAP is a partition that does not contain a file system. 
USR is a partition that does contain a file system. 
ALTS contains alternate sectors to which the driver re-maps bad sec- 
tors. Currently a maximum of 62 alternate sectors is supported. 
OTHER is a partition that the UNIX system does not know how to 
handle, such as MS-DOS space. 

perm = permname 

specifies a permission type for the partition. Permissions are not 
mutually exclusive. 

RO indicates that the partition cannot be written upon. Normally, 
write access is granted (standard UNIX system file permissions not- 
withstanding). 

NOMOUNT disallows the driver from mounting the file system that 
may be contained in the partition. 
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VALID indicates that the partition contains valid data. Any partition 
added with the -A flag will be marked VALID. 

start = number 

is the starting sector number for the partition. NOTE: For ATS 86 
systems, the root file system should start at the second track of the 
cylinder which is the beginning of the active UNIX system 'fdisk' 
partition. This allows space for the writing of the boot code. 

size = number 

is the size, in sectors, of the partition. 

When mkpart is run, it first attempts to read the volume label (for multibus 
systems) or the 'fdisk' table (for AT386 systems), the VTOC block, and the 
alternate sector table. If any of the structures is invalid or cannot be read, 
or if the -i flag is specified, the internal tables are initialized to default 
values for the device specified (taken from the device stanza in the partition 
file). If the -F flag is specified, the device is formatted. If either the -V or 
-V flag is specified, the appropriate surface analysis is performed. After 
these steps, partitions are deleted or added as required. Next, any bad sec- 
tors specified in the partition file, found during surface analysis, or specified 
in the command line with -A flags are merged into the alternate sectors 
table. Note that an alternate partition must exist for any bad-sector marking 
to occur, as bad sectors are assigned good alternates at this point. Finally, 
the boot program is written to track of cylinder (Multibus systems) or 
the cylinder where the active UNIX system 'fdisk' partition starts (AT386 
systems). If -b was not the only parameter specified, the updated VTOC 
and alternates tables are written, and the disk driver is instructed to re-read 
the tables when the drive is opened the next time. When only -t is speci- 
fied, only a listing is created and no updating occurs. 

FILES 

/etc/partitions /etc/boot /dev/rdsk/*sO 

BUGS 

Currently, very little consistency checking is done. No checks are made to 
ensure that the 'fdisk' partition table is consistent with the UNIX system 
partitions placed in the VTOC. If a DOS 'fdisk' partition is started at 
cylinder 0, DOS will happily overwrite the UNIX system VTOC. 
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NAME 

more - view a file one full screen at a time 
SYNOPSIS 

more [ -cdflsurw ][-«][ +linenumber ] [ + /pattern ] [ name ... ] 
DESCRIPTION 

The more filter allows examination of continuous text one full screen at a 
time. It normally pauses after each full screen, printing "--More—" at the 
bottom of the screen. If the user then presses the RETURN key, one more 
line is displayed. If the user presses the SPACEBAR, another full screen is 
displayed. Other possibilities are described below. 

The command line options include the following: 

-n An integer which is the size (in lines) of the window which 

more will use instead of the default. 

-c More draws each page by beginning at the top of the screen 

and erasing each line just before it displays a new line. This 
avoids scrolling the screen, making it easier to read while more 
is writing. This option is ignored if the terminal does not have 
the ability to clear to the end of a line. 

-d More prompts with the message "Hit space to continue, Del to 

abort" at the end of each full screen. This is useful if more is 
being used as a filter in some setting, such as a class, where 
many users may be inexperienced. 

-f This option causes more to count logical lines, rather than 

screen lines. That is, long lines are not folded. This option is 
recommended if nroff output is being piped through m/, since 
the latter may generate escape sequences. These escape 
sequences contain characters that would ordinarily occupy 
screen positions, but that do not print when they are sent to 
the terminal as part of an escape sequence. Thus, more may 
think that lines are longer than they actually are and fold lines 
erroneously. 

-1 Does not treat CTRL-L (FORMFEED) specially. If this option is 

not given, more pauses after any line that contains a CTRL-L, as 
if the end of a full screen had been reached. Also, if a file 
begins with a FORMFEED, the screen is cleared before the file is 
printed. 

-s Squeezes multiple blank lines from the output, producing only 

one blank line. Especially helpful when viewing nroff output, 
this option maximizes the useful information present on the 
screen. 

-u Normally, more handles underlining, such as that produced by 

nroff in a manner appropriate to the particular terminal: if the 
terminal can perform underlining or has a stand-out mode, 
more outputs appropriate escape sequences to enable underlin- 
ing or stand-out mode for underlined information in the source 
file. The -u option suppresses this processing. 
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-r Normally, more ignores control characters that it does not 

interpret in some way. The -r option causes these to be 
displayed as *C, where "C" stands for any such control char- 
acter. 

_w Normally, more exits when it comes to the end of its input. 

With -w, however, more prompts and waits for any key to be 

struck before exiting. 
+linenumber Starts up at linenumber. 

+ /pattern Starts up two lines before the line containing the regular 
expression pattern. 

More looks in the /etc/termcap file for the terminal characteristics and the 
default window size. For example, on a terminal capable of displaying 24 
lines, the default window size is 22 lines. 

More looks in the environment variable, MORE, to preset any flags desired. 
For example, if you prefer to view files using the -c mode of operation, the 
shell command, "MORE=-c", in the .profile file causes all invocations of 
more to use this mode. 

If more is reading from a file, rather than a pipe, then a percentage is 
displayed along with the "-More--" prompt. This gives the fraction of the 
file (in characters, not lines) that has been read so far. 

Other sequences which may be typed when more pauses, and their effects, 
are as follows (/ is an optional integer argument, defaulting to 1): 

Displays i more lines, (or another full screen if no argument is 
given). 

Displays 11 more lines (a "scroll"). If i is given, then the 
scroll size is set to i . 

Same as CTRL-D. 

Same as typing a space except that z, if present, becomes the 
new window size. 

Skips i lines and prints a full screen of lines. 
Skips i full screens and prints a full screen of lines. 
Exits from more. 

Displays the current line number. 

Starts up the screen editor vi at the current line. (Note that vi 
may not be available with your system.) 

Help command; gives a description of all the more commands. 



i <space> 
CTRL-D 

d 

iz 

is 
if 

qor Q 



h or ? 
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i/expr Searches for the zth occurrence of the regular expression expr. 

If there are less than / occurrences of expr, and the input is a 
file (rather than a pipe), then the position in the file remains 
unchanged. Otherwise, a full screen is displayed, starting two 
lines before the place where the expression was found. You 
can use the ERASE and KILL characters to edit the regular 
expression. Erasing back past the first column cancels the 
search command. 

i n Searches for the fth occurrence of the last regular expression 

entered. 

' (Single quotation mark) Goes to the point from which the last 

search started. If no search has been performed in the current 
file, this command goes back to the beginning of the file. 

kommand Invokes a shell with command. The % and ! characters in com- 
mand are replaced with the current filename and the previous 
shell command respectively. If there is no current filename, % 
is not expanded. The sequences, "\%" and ''\!", are replaced 
by and "\", respectively. 

Skips to the fth next file given in the command line (skips to 
last file if n doesn't make sense). 

i-V Skips to the fth previous file given in the command line. If 

this command is given in the middle of printing out a file, 
more goes back to the beginning of the file. If f doesn't make 
sense, more skips back to the first file. If more is not reading 
from a file, the bell rings and nothing else happens. 

:f Displays the current filename and line number. 

:q or :Q Exits from more (same as q or Q). 

Repeats the previous command. 

The commands take effect immediately, i.e., you do not need to press the 
RETURN key. Up to the time when the command character itself is given, 
you can press the KILL character to cancel the numerical argument being 
formed. In addition, you can press the ERASE character to redisplay the 
Moxe--(xx%y' message. 

The terminal is set to noecho mode by this program so that the output can 
be continuous. This means that what you type does not show on your ter- 
minal, except for the slash (/) and exclamation (!) commands. 

If the standard output is not a teletype, more acts just like cat, except that a 
header is printed before each file (if there is more than one file). 

A sample usage of more in previewing nroff output would be: 

nroff -ms +2 doc.n I more -s 
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FILES 

/usr/lib/terminfo/?/* terminal information database 
/usr/lib/more.help help file 

SEE ALSO 

csh(l), sh(l). 

environ(5) in the Programmer's Reference Manual. 

NOTES 

The vi and help options may not be available. 

Before displaying a file, more attempts to detect whether the file is an 
unprintable binary file such as a directory or an executable binary image. If 
more concludes that a file is unprintable, more refuses to print it. However, 
more cannot detect all possible kinds of unprintable files. 
This utility was developed at the University of California at Berkeley and is 
used with permission. 
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NAME 

mount, umount - mount and unmount file systems and remote resources 
SYNOPSIS 

/etc/mount [-r] [-f fstyp] special directory 
/etc/mount [-r] [-c] -d resource directory 
/etc/mount 
/etc/umount special 
/etc/umount -d resource 

DESCRIPTION 

File systems other than root ( / ) are considered removable in the sense that 
they can be either available to users or unavailable, mount announces to 
the system that special, a block special device or resource, a remote resource, 
is available to users from the mount point directory, directory must exist 
already; it becomes the name of the root of the newly mounted special or 
resource. A unique resource may be mounted only once (no multiple 
mounts). 

mount, when entered with arguments, adds an entry to the table of mounted 
devices, /etc/mnttab. umount removes the entry. If invoked with no argu- 
ments, mount prints the entire mount table. If invoked with any of the fol- 
lowing partial argument lists, mount will search /etc/fstab to fill in the 
missing arguments: special, -d resource, directory, or -d directory. 

The following options are available: 

-r indicates that special or resource is to be mounted read-only. If 

special or resource is write-protected or read-only advertised, this 
flag must be used. 

-d indicates that resource is a remote resource that is to be mounted 

on directory or unmounted. To mount a remote resource. 
Remote File Sharing must be up and running and the resource 
must be advertised by a remote computer [see rfstart(lM) and 
adv{lM)]. If -d is not used, special must be a local block special 
device. 

-c indicates that remote reads and writes should not be cached in 

the local buffer pool, -c is used in conjunction with -d. 

-f fstyp indicates that fstyp is the file system type to be mounted. If this 
argument is omitted, it defaults to the root fstyp. 

special indicates the block special device that is to be mounted on direc- 
tory. 

resource indicates the remote resource name that is to be mounted on a 
directory. 

directory indicates the directory mount point for special or resource. (The 
directory must already exist.) 

umount announces to the system that the previously mounted special or 
resource is to be made unavailable. If invoked with directory or -d directory, 
umount will search /etc/fstab to fill in the missing argument(s). 
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mount can be used by any user to list mounted file systems and resources. 
Only a super-user can mount and unmount file systems. 

FILES 

/etc/mnttab mount table 
/etc/fstab file system table 

SEE ALSO 

adv(lM), fuser(lM), nsquery(lM), rfstart(lM), rmntstat(lM), setmnt(lM), 
unadv(lM). 

mount(2), umount(2), fstab(4), mnttab(4) in the Programmer's Reference 
Manual. 

"Remote File Sharing" chapter, Operations /System Administration Guide, for 
guidelines on mounting remote resources. 

DIAGNOSTICS 

If the mount(2) system call fails, mount prints an appropriate diagnostic. 
mount issues a warning if the file system to be mounted is currently labeled 
under another name. A remote resource mount will fail if the resource is 
not available or if Remote File Sharing is not running or if it is advertised 
read-only and not mounted with -r. 

umount fails if special or resource is not mounted or if it is busy, special or 
resource is busy if it contains an open file or some user's working directory. 
In such a case, you can use fuser{lM) to list and kill processes that are using 
special or resource. 

WARNINGS 

Physically removing a mounted file system diskette from the diskette drive 
before issuing the umount command damages the file system. 
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NAME 

mountall, umountall - mount, unmount multiple file systems 
SYNOPSIS 

/etc/mountall [-] [ file-system- table ] ... 
/etc/umountall [-k] 

DESCRIPTION 

These commands may be executed only by the super-user. 

The mountall command is used to mount file systems according to a file- 
system-table, (/etc/fstab is the default file system table.) The special file 
name " - " reads from the standard input. 

Before each file system is mounted, it is checked using fsstat(lM) to see if it 
appears mountable. If the file system does not appear mountable, it is 
checked, using /sc/c(l M), before the mount is attempted. 

The umountall command causes all mounted file systems except root to be 
unmounted. The -k option sends a SIGKILL signal, via fuser{lM), to 
processes that have files open. 

FILES 

File-system-table format: 

column 1 block special file name of file system 

column 2 mount-point directory 

column 3 " -r " if to be mounted read-only; " -d " if remote 

column 4 (optional) file system type string 

column 5+ ignored 

White space separates columns. Lines beginning with "#" are comments. 
Empty lines are ignored. 

A typical file-system-table might read: 
/dev/dsk/Osl /usr -r S51K 

SEE ALSO 

fsck(lM), fsstat(lM), fuser(lM), mount(lM). 
signal(2), fstab(4) in the Programmer's Reference Manual 
DIAGNOSTICS 

No messages are printed if the file systems are mountable and clean. 

Error and warning messages come from fsck{lM), fsstat(lM), and mount(lM). 

NOTES 

The information displayed in Column 3 will only appear if the file system 
was mounted as a read-only or remote resource. 
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NAME 

mvdir - move a directory 

SYNOPSIS 

/etc/mvdir dirname name 

DESCRIPTION 

The mvdir command moves directories within a file system. Dirname must 
be a directory. If name does not exist, it will be created as a directory. If 
name does exist, dirname will be created as name/dirname. Dirname and 
name may not be on the same path; that is, one may not be subordinate to 
the other. For example: 

mvdir x/y x/z 

is legal, but 

mvdir x/y x/y/z 

is not. 

SEE ALSO 

mkdir(l), mv(l). 

WARNINGS 

Only the super-user can use mvdir. 
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NAME 

nawk - pattern scanning and processing language 
SYNOPSIS 

nawk [-F re] [parameter...] ['prog'] [-f progfile] [file...] 
DESCRIPTION 

nawk is a new version of awk that provides capabilities unavailable in previ- 
ous versions. This version will become the default version of awk in the 
next major UNIX system release. 

The -F re option defines the input field separator to be the regular expres- 
sion re. 

Parameters, in the form x=... y=... may be passed to nawk, where x and y 
are nawk built-in variables (see list below). 

nawk scans each input file for lines that match any of a set of patterns speci- 
fied in prog. The prog string must be enclosed in single quotes (') to protect 
it from the shell. For each pattern in prog, there may be an associated 
action performed when a line of a file matches the pattern. The set of 
pattern-action statements may appear literally as prog or in a file specified 
with the -f progfile option. 

Input files are read in order; if there are no files, the standard input is read. 
The file name - means the standard input. Each input line is matched 
against the pattern portion of every pattern-action statement; the associated 
action is performed for each matched pattern. 

An input line is normally made up of fields separated by white space. (This 
default can be changed by using the FS built-in variable or the -F re 
option.) The fields are denoted $1, $2, . . . ; $0 refers to the entire line. 

A pattern-action statement has the form: 

pattern { action } 

Either pattern or action may be omitted. If there is no action with a pattern, 
the matching line is printed. If there is no pattern with an action, the action 
is performed on every input line. 

Patterns are arbitrary Boolean combinations ( !, | | , &&, and parentheses) of 
relational expressions and regular expressions. A relational expression is 
one of the following: 

expression relop expression 
expression matchop regular expression 

where a relop is any of the six relational operators in C, and a matchop is 
either ~ (contains) or ! ~ (does not contain). A conditional is an arith- 
metic expression, a relational expression, the special expression 

var in array, 
or a Boolean combination of these. 

The special patterns BEGIN and END may be used to capture control before 
the first input line has been read and after the last input line has been read. 



- 1 - 



NAWK(l) 



(Editing Package) 



NAWK(l) 



respectively. 

Regular expressions are as in egrep [see grep(l)]. In patterns they must be 
surrounded by slashes. Isolated regular expressions in a pattern apply to 
the entire line. Regular expressions may also occur in relational expressions. 
A pattern may consist of two patterns separated by a comma; in this case, 
the action is performed for all lines between an occurrence of the first pat- 
tern and the next occurrence of the second pattern. 

A regular expression may be used to separate fields by using the -F re 
option or by assigning the expression to the built-in variable FS. The 
default is to ignore leading blanks and to separate fields by blanks and/or 
tab characters. However, if FS is assigned a value, leading blanks are no 
longer ignored. 

Other built-in variables include: 



ARGC command line argument count 

ARGV command line argument array 

FILENAME name of the current input file 

FNR ordinal number of the current record in the current file 

FS input field separator regular expression (default blank) 

NF number of fields in the current record 

NR ordinal number of the current record 

OFMT output format for numbers (default %.6g) 

OFS output field separator (default blank) 

ORS output record separator (default new-line) 

RS input record separator (default new-line) 



An action is a sequence of statements. A statement may be one of the fol- 
lowing: 

if ( conditional ) statement [ else statement ] 

while ( conditional ) statement 

do statement while ( conditional ) 

for ( expression ; conditional ; expression ) statement 

for ( var in array ) statement 

delete array[subscript] 

break 

continue 

{ [ statement ] ... } 

expression # commonly variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 

next # skip remaining patterns on this input line 

exit [expr] # skip the rest of the input; exit status is expr 

return [expr] 
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Statements are terminated by semicolons, new-lines, or right braces. An 
empty expression-list stands for the whole input line. Expressions take on 
string or numeric values as appropriate, and are built using the operators +, 
-/*,/, %, and concatenation (indicated by a blank). The C operators ++, 
"-/ +=/ *=/ /=/ and %= are also available in expressions. Variables 
may be scalars, array elements (denoted x[i]), or fields. Variables are initial- 
ized to the null string or zero. Array subscripts may be any string, not 
necessarily numeric; this allows for a form of associative memory. String 
constants are quoted ( " ). 

The print statement prints its arguments on the standard output, or on a file 
if >expression is present, or on a pipe if I cmd is present. The arguments are 
separated by the current output field separator and terminated by the output 
record separator. The printf statement formats its expression list according 
to the format [see printf{3S) in the Programmer's Reference Manual]. 

nawk has a variety of built-in functions: arithmetic, string, input/output, 
and general. 

The arithmetic functions are: atanl, cos, exp, int, log, rand, sin, sqrt, and 
srand, int truncates its argument to an integer, rand returns a random 
number between and 1. srand ( expr ) sets the seed value for rand to expr 
or uses the time of day if expr is omitted. 

The string functions are: 

gsub(/br, repl, in) 

behaves like sub (see below), except that it replaces suc- 
cessive occurrences of the regular expression (like the ed 
global substitute command). 

index ( s , t) returns the position in string s where string t first occurs, 
or if it does not occur at all. 

lengthfl ( s ) returns the length of its argument taken as a string, or of 
the whole line if there is no argument. 

match ( s , re) returns the position in string s where the regular expres- 
sion re occurs, or if it does not occur at all. RSTART is 
set to the starting position (which is the same as the 
returned value), and RLENGTH is set to the length of the 
matched string. 

split(s, a, fs) splits the string s into array elements a[l], a[2], a[n], and 
returns n . The separation is done with the regular expres- 
sion fs or with the field separator FS if fs is not given. 

sprinti(fmt, expr, expr, . . .) 

formats the expressions according to the printf{3S) format 
given by fmt and returns the resulting string. 

subifor, repl, in) substitutes the string repl in place of the first instance of 
the regular expression for in string in and returns the 
number of substitutions. If in is omitted, nawk substitutes 
in the current record ($0). 
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substr(s, m, n) returns the n -character substring of s that begins at posi- 
tion m. 

The input/output and general functions are: 

close (filename) closes the file or pipe named filename, 

cmdl getline pipes the output of cmd into getline; each successive call 
to getline returns the next line of output from cmd. 

getline sets $0 to the next input record from the current input file. 

getline < file sets $0 to the next record from file. 

getline var sets variable var instead. 

getline var < file 

sets var from the next record of file . 
system ( cmd ) executes cmd and returns its exit status. 
All forms of getline return 1 for successful input, for end of file, and -1 for 
an error. 

naivk also provides user-defined functions. Such functions may be defined 
(in the pattern position of a pattern-action statement) as 

function name(args,...) { stmts } 
func name(args,...) { stmts } 

Function arguments are passed by value if scalar and by reference if array 
name. Argument names are local to the function; all other variable names 
are global. Function calls may be nested and functions may be recursive. 
The return statement may be used to return a value. 

EXAMPLES 

Print lines longer than 72 characters: 

length > 72 

Print first two fields in opposite order: 
{ print $2, $1 } 

Same, with input fields separated by comma and/or blanks and tabs: 
BEGIN { FS = ",[ \t]*l[ \t]+" } 
{ print $2, $1 } 

Add up first column, print sum and average: 
{ s += $1 } 

END { print "sum is", s, " average is", s/NR } 

Print fields in reverse order: 

{ for (i = NF; i > 0; — i) print $i } 
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Print all lines between start/stop pairs: 
/start/, /stop/ 

Print all lines whose first field is different from previous one: 
$1 != prev { print; prev = $1 } 

Simulate echo{l): 

BEGIN { 

for (i = 1; i < ARGC; i++) 

printf "%s", ARGVp] 

printf "\n" 
exit 

} 

Print file, filling in page numbers starting at 5: 

/Page/ { $2 = n++; } 
{ print } 

command line: nawk -f program n=5 input 

SEE ALSO 

grep(l), sed(l). 

lex(l), printf(3S) in the Programmer's Reference Manual. 

BUGS 

Input white space is not preserved on output if fields are involved. 

There are no explicit conversions between numbers and strings. To force an 
expression to be treated as a number, add to it; to force it to be treated as 
a string, concatenate the null string ( " " ) to it. 
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NAME 

ncheck - generate path names from i-numbers 
SYNOPSIS 

/etc/ncheck [ -i i-numbers ] [ -a ] [ -s ] [ file-system ] 
DESCRIPTION 

The ncheck command with no arguments generates a path name vs. i- 
number list of all files on a set of default file systems (see /etc /checklist). 
Names of directory files are followed by /.. 

The options are as follows: 

-i limits the report to only those files whose i-numbers follow. 

-a allows printing of the names . and which are ordinarily 
suppressed. 

-s limits the report to special files and files with set-user-ID mode. 
This option may be used to detect violations of security policy. 

File system must be specified by the file system's special file. 

The report should be sorted so that it is more useful. 

SEE ALSO 

fsck(lM), sort(l). 

DIAGNOSTICS 

If the file system structure is not consistent, ?? denotes the ''parent" of a 
parentless file, and a path name beginning with ... denotes a loop. 



- 1 - 



NEWFORM(l) 



(Editing Package) 



NEWFORM(l) 



NAME 

newform - change the format of a text file 
SYNOPSIS 

newform [-s] [-itabspec] [-otabspec] [-bn] [-en] [-pn] [-an] [-f] [-cchar] 
[-In] [files] 

DESCRIPTION 

The newform command reads lines from the named files, or the standard 
input if no input file is named, and reproduces the lines on the standard 
output. Lines are reformatted in accordance with command line options in 
effect. 

Except for -s, command line options may appear in any order, may be 
repeated, and may be intermingled with the optional files. Command line 
options are processed in the order specified. This means that option 
sequences like "-el5 -160" will yield results different from ''-160 -el5''. 
Options are applied to all files on the command line. 

-s Shears off leading characters on each line up to the first tab and 

places up to 8 of the sheared characters at the end of the line. If 
more than 8 characters (not counting the first tab) are sheared, 
the eighth character is replaced by a * and any characters to the 
right of it are discarded. The first tab is always discarded. 

An error message and program exit will occur if this option is 
used on a file without a tab on each line. The characters sheared 
off are saved internally until all other options specified are 
applied to that line. The characters are then added at the end of 
the processed line. 

For example, to convert a file with leading digits, one or more 
tabs, and text on each line, to a file beginning with the text, all 
tabs after the first expanded to spaces, padded with spaces out to 
column 72 (or truncated to column 72), and the leading digits 
placed starting at column 73, the command would be: 

newform -s -i -1 -a -e file-name 

Input tab specification: expands tabs to spaces, according to the 
tab specifications given. Tabspec recognizes all tab specification 
forms described in tabs(l). In addition, tabspec may be ~, in 
which newform assumes that the tab specification is to be found 
in the first line read from the standard input [see f spec (4)]. If no 
tabspec is given, tabspec defaults to -8. A tabspec of -0 expects 
no tabs; if any are found, they are treated as -1. 

Output tab specification: replaces spaces by tabs, according to 
the tab specifications given. The tab specifications are the same 
as for -itabspec. If no tabspec is given, tabspec defaults to -8. A 
tabspec of -0 means that no spaces will be converted to tabs on 
output. 

Truncate n characters from the beginning of the line when the 
line length is greater than the effective line length (see -in). 
Default is to truncate the number of characters necessary to 



-itabspec 



-otabspec 
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obtain the effective line length. The default value is used when 
-b with no n is used. This option can be used to delete the 
sequence numbers from a COBOL program as follows: 

newform -11 -b7 file-name 

-en Same as -bn except that characters are truncated from the end of 

the line. 

-pn Prefix n characters (see -ck) to the beginning of a line when the 

line length is less than the effective line length. Default is to 
prefix the number of characters necessary to obtain the effective 
line length. 

-SLTi Same as -pn except characters are appended to the end of a line. 

-f Write the tab specification format line on the standard output 

before any other lines are output. The tab specification format 
line which is printed will correspond to the format specified in 
the last -o option. If no -o option is specified, the line which is 
printed will contain the default specification of -8. 

-ck Change the prefix/append character to k. Default character for k 

is a space. 

-In Set the effective line length to n characters. If n is not entered, 

-1 defaults to 72. The default line length without the -1 option is 
80 characters. Note that tabs and backspaces are considered to 
be one character (use -i to expand tabs to spaces). 

The -11 must be used to set the effective line length shorter than any exist- 
ing line in the file so that the -b option is activated. 

DIAGNOSTICS 

All diagnostics are fatal. 

usage: . . . newform was called with a bad option. 

not -s format There was no tab on one line. 

can't open file Self-explanatory. 

internal line too long A line exceeds 512 characters after being 

expanded in the internal work buffer. 
tabspec in error A tab specification is incorrectly formatted, or 

specified tab stops are not ascending. 
tabspec indirection illegal A tabspec read from a file (or standard input) may 

not contain a tabspec referencing another file (or 

standard input). 

- normal execution 

1 - for any error 

SEE ALSO 

csplit(l), tabs(l). 

fspec(4) in the Programmer's Reference Manual. 
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BUGS 

The newform command normally only keeps track of physical characters; 
however, for the -i and -o options, newform will keep track of backspaces 
in order to line up tabs in the appropriate logical columns. 

newform will not prompt the user if a tabspec is to be read from the standard 
input (by use of -i — or -o — ). 

If the -f option is used, and the last -o option specified was -o — , and was 
preceded by either a -o — or a -i— , the tab specification format line will be 
incorrect. 
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NAME 

newgrp - log in to a new group 

SYNOPSIS 

newgrp [-] [ group ] 

DESCRIPTION 

The newgrp command changes a user's group identification. The user 
remains logged in and the current directory is unchanged, but calculations 
of access permissions to files are performed with respect to the new real and 
effective group IDs. The user is always given a new shell, replacing the 
current shell, by newgrp, regardless of whether it terminated successfully or 
due to an error condition (i.e., unknown group). 

Exported variables retain their values after invoking newgrp; however, all 
unexported variables are either reset to their default value or set to null. 
System variables (such as PSl, PS2, PATH, MAIL, and HOME), unless 
exported by the system or explicitly exported by the user, are reset to 
default values. For example, a user has a primary prompt string (PSl) other 
than $ (default) and has not exported PSl. After an invocation of newgrp , 
successful or not, their PSl will now be set to the default prompt string $. 
Note that the shell command export [see sfi(l)] is the method to export vari- 
ables so that they retain their assigned value when invoking new shells. 

With no arguments, newgrp changes the group identification back to the 
group specified in the user's password file entry. This is a way to exit the 
effect of an earlier newgrp command. 

If the first argument to newgrp is a -, the environment is changed to what 
would be expected if the user actually logged in again as a member of the 
new group. 

A password is demanded if the group has a password and the user does 
not, or if the group has a password and the user is not listed in /etc/group 
as being a member of that group. 

FILES 

/etc/group system's group file 

/etc/passwd system's password file 

SEE ALSO 

login(l), sh(l). 

group(4), passwd(4), environ(5) in the Programmer's Reference Manual 

BUGS 

There is no convenient way to enter a password into /etc/group. Use of 
group passwords is not encouraged, because, by their very nature, they 
encourage poor security practices. Group passwords may disappear in the 
future. 
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NAME 

news - print news items 

SYNOPSIS 

news [ -a ] [ -n ] [ -s ] [ items ] 

DESCRIPTION 

The news command is used to keep the user informed of current events. By 
convention, these events are described by files in the directory /usr/news. 

When invoked without arguments, news prints the contents of all current 
files in /usr/news, most recent first, with each preceded by an appropriate 
header, news stores the "currency" time as the modification date of a file 
named .news_time in the user's home directory (the identity of this direc- 
tory is determined by the environment variable $HOME); only files more 
recent than this currency time are considered "current." 

-a option causes news to print all items, regardless of currency. In this 
case, the stored time is not changed. 

-n option causes news to report the names of the current items without 
printing their contents, and without changing the stored time. 

-s option causes news to report how many current items exist, without 
printing their names or contents, and without changing the stored 
time. It is useful to include such an invocation of news in one's 
.profile file, or in the system's /etc/profile. 

All other arguments are assumed to be specific news items that are to be 
printed. 

If a delete is typed during the printing of a news item, printing stops and 
the next item is started. Another delete within one second of the first 
causes the program to terminate. 

FILES 

/etc/profile 
/usr/news/* 
$HOME /.news_time 

SEE ALSO 

profile(4), environ(5) in the Programmer's Reference Manual. 
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NAME 

nice - run a command at low priority 
SYNOPSIS 

nice [ -increment ] command [ arguments ] 
DESCRIPTION 

The nice command executes command with a lower CPU scheduling priority. 
If the increment argument (in the range 1-19) is given, it is used; if not, an 
increment of 10 is assumed. 

The super-user may run commands with priority higher than normal by 
using a negative increment, e.g., — 10. 

SEE ALSO 

nohup(l). 

nice(2) in the Programmer's Reference Manual. 
DIAGNOSTICS 

The nice command returns the exit status of the subject command. 

BUGS 

An increment larger than 19 is equivalent to 19. 
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NAME 

nl - line-numbering filter 
SYNOPSIS 

nl [-htype] [-btype] [-ftype] [-vstart#] [-iincr] [-p] [-Inum] [-ssep] 
[-wwidth] [-nformat] [-ddelim] file 

DESCRIPTION 

The nl command reads lines from the named file or the standard input if no 
file is named and reproduces the lines on the standard output. Lines are 
numbered on the left in accordance with the command options in effect. 

nl views the text it reads in terms of logical pages. Line numbering is reset 
at the start of each logical page. A logical page consists of a header, a 
body, and a footer section. Empty sections are valid. Different line- 
numbering options are independently available for header, body, and footer 
(e.g., no numbering of header and footer lines while numbering blank lines 
only in the body). 

The start of logical page sections are signaled by input lines containing 
nothing but the following delimiter character(s): 

Line contents Start of 

\:\:\: header 

\:\: body 

\: footer 

Unless optioned otherwise, nl assumes the text being read is in a single log- 
ical page body. 

Command options may appear in any order and may be intermingled with 
an optional file name. Only one file may be named. The options are: 

-btype Specifies which logical page body lines are to be numbered. 
Recognized types and their meaning are: 

a number all lines 

t number lines with printable text only 

n no line-numbering 

pstring number only lines that contain the regular expression 
specified in string. 

Default type for logical page body is t (text lines numbered). 

-htype Same as -btype except for header. Default type for logical page 
header is n (no lines numbered). 

-itype Same as -btype except for footer. Default for logical page footer 
is n (no lines numbered). 

-vstartU StartiP is the initial value used to number logical page lines. 
Default is 1. 
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-liner 
-P 

-Inum 



-ssep 



-vf width 



-nformat 



-dxx 



Incr is the increment value used to number logical page lines. 
Default is 1. 

Do not restart numbering at logical page delimiters. 

Num is the number of blank lines to be considered as one. For 
example, -12 results in only the second adjacent blank being 
numbered (if the appropriate -ha, -ba, and/or -fa option is set). 
Default is 1. 

Sep is the character(s) used in separating the line number and the 
corresponding text line. Default sep is a tab. 

Width is the number of characters to be used for the line number. 
Default width is 6. 

Format is the line-numbering format. Recognized values are: In, 
left justified, leading zeroes suppressed; rn, right justified, lead- 
ing zeroes suppressed; rz, right justified, leading zeroes kept. 
Default format is rn (right justified). 

The delimiter characters specifying the start of a logical page sec- 
tion may be changed from the default characters (\:) to two 
user-specified characters. If only one character is entered, the 
second character remains the default character (:). No space 
should appear between the -d and the delimiter characters. To 
enter a backslash, use two backslashes. 



EXAMPLE 

The command: 



nl -vlO -ilO -d!+ filel 

will number filel starting at line number 10 with an increment of ten. The 
logical page delimiters are !+. 

SEE ALSO 

pr(l). 
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NAME 

nlsadmin - network listener service administration 

SYNOPSIS 

nlsadmin -x 

nlsadmin [ options ] net_spec 
DESCRIPTION 

nlsadmin administers the network listener process(es) on a machine. Each 
network has a separate instance of the network listener process associated 
with it; each instance (and thus, each network) is configured separately. 
The listener process "listens" to the network for service requests, accepts 
requests when they arrive, and spawns servers in response to those service 
requests. The network listener process will work with any network (more 
precisely, with any transport provider) that conforms to the transport pro- 
vider specification. 

The listener supports two classes of service: a general listener service, serv- 
ing processes on remote machines, and a terminal login service, for termi- 
nals connected directly to a network. The terminal login service provides 
networked access to this machine in a form suitable for terminals connected 
directly to the network. However, this direct terminal service requires spe- 
cial associated software, and is only available with some networks (for 
example, the AT&T STARLAN network). 

nlsadmin can establish a listener process for a given network, configure the 
specific attributes of that listener, and start and kill the listener process for 
that network, nlsadmin can also report on the listener processes on a 
machine, either individually (per network) or collectively. 

The following list shows how to use nlsadmin. In this list, net— spec 
represents a particular listener process. Specifically, netspec is the relative 
path name of the entry under /dev for a given network (that is, a transport 
provider). Changing the list of services provided by the listener produces 
immediate changes, while changing an address on which the listener listens 
has no effect until the listener is restarted. The following combination of 
options can be used. 

no options will give a brief usage message. 

-X will report the status of all of the listener processes 

installed on this machine. 

net-jspec will print the status of the listener process for 

net— spec. 

-q net—spec will query the status of the listener process for the 

specified network, and will reflect the result of that 
query in its exit code. If a listener process is active, 
nlsadmin will exit with a status of 0; if no process is 
active, the exit code will be 1; the exit code will be 
greater than 1 in case of error. 

-V net^pec will print a verbose report on the servers associated 

with netspec, giving the service code, status, com- 
mand, and comment for each. It also specifies the 
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uid the server will run as, and the list of modules to 
be pushed, if any, before the server is started. 

-z service— code netspec 

will print a report on the server associated with 
netspec that has service code service— code, giving 
the same information as in the -v option. 

-q -z service— code netspec 

will query the status of the service with service code 
service— code on network netspec, and will exit with 
a status of if that service is enabled, 1 if that ser- 
vice is disabled, and greater than 1 in case of error. 

-1 addr netspec will change or set the address on which the listener 

listens (the general listener service). This is the 
address generally used by remote processes to access 
the servers available through this listener (see the -a 
option, below), addr is the transport address on 
which to listen and is interpreted using a syntax that 
allows for a variety of address formats. By default 
addr is interpreted as the symbolic ASCII representa- 
tion of the transport address. An addr preceded by a 
\x will let you enter an address in hexadecimal nota- 
tion. Note that addr must appear as a single word to 
the shell and must be quoted if it contains any 
blanks. 

If addr is just a dash ("-")/ nlsadmin will report the 
address currently configured, instead of changing it. 

A change of address will not take effect until the 
next time the listener for that network is started. 

will change or set the address on which the listener 
listens for requests for terminal service, but is other- 
wise similar to the -1 option above. A terminal ser- 
vice address should not be defined unless the 
appropriate remote login software is available; if 
such software is available, it must be configured as 
service code 1 (see the -a option, below). 

will initialize or change a listener process for the net- 
work specified by netspec; that is, it will create and 
initialize the files required by the listener. Note that 
the listener should only be initialized once for a 
given network, and that doing so does not actually 
invoke the listener for that network. The listener 
must be initialized before assigning addressing or 
services. 

[-m] -a service— code [-p modules] [-w id] -c cmd -y comment netspec 

will add a new service to the list of services available 
through the indicated listener, servicesode is the 



-t addr netspec 



-i netspec 
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code for the service, cmd is the command to be 
invoked in response to that service code, comprised 
of the full path name of the server and its argu- 
ments, and comment is a brief (free- form) description 
of the service for use in various reports. Note that 
cmd must appear as a single v^ord to the shell, so if 
arguments are required, the cmd and its arguments 
must be surrounded by quotes. Similarly, the com- 
ment must also appear as a single v^ord to the shell. 
When a service is added, it is initially enabled (see 
the -e and -d options below). 

If the -m option is specified, the entry v^ill be 
marked as an administrative entry. Service codes 1 
through 100 are reserved for administrative entries, 
which are those that require special handling inter- 
nally. In particular, code 1 is assigned to the remote 
login service, which is the service automatically 
invoked for connections to the terminal login 
address. 

The -m option used with the -a option indicates that 
special handling internally is required for those 
servers added with the -m set. This internal han- 
dling is in the form of code embedded on the listener 
process. 

If the -p option is specified, then modules will be 
interpreted as a list of STREAMS modules for the 
listener to push before starting the service being 
added. The modules are pushed in the order they 
are specified, modules should be a comma-separated 
list of modules, with no white space included. 

If the -w option is specified, then id is interpreted as 
the user name from /etc/passwd that the listener 
should look up. From the user name, the listener 
should obtain the user ID, the group ID, and the 
home directory for use by the server. If -w is not 
specified, the default is to use the user ID listen. 

A service must explicitly be added to the listener for 
each network on which that service is to be avail- 
able. This operation will normally be performed 
only when the service is installed on a machine, or 
when populating the list of services for a new net- 
work. 

-r service— code netspec 

will remove the entry for the service— code from that 
listener's list of services. This will normally be per- 
formed only in conjunction with the de-installation 
of a service from a machine. 
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-e service— code netspec 
-d service— code netspec 

will enable or disable (respectively) the service indi- 
cated by service— code for the specified network. The 
service must have previously been added to the 
listener for that network (see the -a option above). 
Disabling a service will cause subsequent service 
requests for that service to be denied, but the 
processes from any prior service requests that are 
still running will continue unaffected. 

will start and kill (respectively) the listener process 
for the indicated network. These operations will 
normally be performed as part of the system startup 
and shutdown procedures. Before a listener can be 
started for a particular network, it must first have 
been initialized, and an address must be defined for 
the general listener service (see the -i and -1 options, 
above). When a listener is killed, processes that are 
still running as a result of prior service requests will 
continue unaffected. 

The listener runs as user ID root, with group ID sys. A special ID, user ID 
listen and group ID adm, should be entered in the /etc/passwd file as a 
default ID for servers. The listener always uses as its home directory 
/usr/net/nls, which is concatenated with netspec to determine the loca- 
tion of the listener configuration information for each network. The home 
directory specified in the /etc/passwd entry for listener will used by 
servers that run as ID listen. 

nlsadmin may be invoked by any user to generate reports, but all operations 
that affect a listener's status or configuration are restricted to the super-user. 

FILES 

/usr /net /n\s/ netspec 

SEE ALSO 

Network Programmer's Guide 



-s net— spec 
-k net— spec 
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NAME 

nohup - run a command immune to hangups and quits 

SYNOPSIS 

nohup command [ arguments ] 

DESCRIPTION 

The nohup command executes command with hangups and quits ignored. If 
output is not re-directed by the user, both standard output and standard 
error are sent to nohup.out. If nohup.out is not writable in the current 
directory, output is redirected to $HOME/nohup.out. 

EXAMPLE 

It is frequently desirable to apply nohup to pipelines or lists of commands. 
This can be done only by placing pipelines and command lists in a single 
file, called a shell procedure. One can then issue: 

nohup sh file 

and the nohup applies to everything in file. If the shell procedure file is to 
be executed often, then the need to type sh can be eliminated by giving file 
execute permission. Add an ampersand and the contents of file are run in 
the background with interrupts also ignored [see sh(l)]: 

nohup file & 

An example of what the contents of file could be is: 
sort ofile > nfile 

SEE ALSO 

chmod(l), nice(l), sh(l), 

signal(2) in the Programmer's Reference Manual. 

WARNINGS 

In the case of the following command 

nohup command 1; command2 
nohup applies only to command 1. The command 

nohup (command 1; command2) 
is syntactically incorrect. 
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NAME 

nsquery - Remote File Sharing name server query 

SYNOPSIS 

nsquery [-h] [name] 

DESCRIPTION 

The nsquery command provides information about resources available to the 
host from both the local domain and from other domains; all resources are 
reported, regardless of whether the host is authorized to access them. 
When used with no options, nsquery identifies all resources in the domain 
that have been advertised as sharable. A report on selected resources can 
be obtained by specifying name, where name is: 

nodename The report will include only those resources available 

from nodename, 

domain. The report will include only those resources available 

from domain. 

domain. nodename The report will include only those resources available 
from domain.nodename. 

When the name does not include the delimiter " . " , it will be interpreted as 
a nodename within the local domain. If the name ends with a delimiter " . " , 
it will be interpreted as a domain name. 

The information contained in the report on each resource includes its adver- 
tised name {domain. resource), the read/write permissions, the server 
{nodename. domain) that advertised the resource, and a brief textual descrip- 
tion. 

When -h is used, the header is not printed. 

A remote domain must be listed in your rfmaster file in order to query that 
domain. 

EXIT STATUS 

If no entries are found when nsquery is executed, the report header is 
printed. 

ERRORS 

If your host cannot contact the domain name server, an error message will 
be sent to standard error. 

SEE ALSO 

adv(lM), unadv(lM). 

rfmaster(4) in the Programmer's Reference Manual. 
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NAME 

od - octal dump 
SYNOPSIS 

od [ -bcdosx ] [ file ] [ [ + ]offset[ . ][ b ] ] 
DESCRIPTION 

The od command dumps file in one or more formats as selected by the first 
argument. If the first argument is missing, -o is default. The meanings of 
the format options are: 

-b Interpret bytes in octal. 

-c Interpret bytes in ASCII. Certain non-graphic characters appear as C 
escapes: null=\0, backspace=\b, form-feed=\f, new-line=\n, 
retum=\r, tab=\t; others appear as 3-digit octal numbers. 

-d Interpret words in unsigned decimal. 

-o Interpret words in octal. 

-s Interpret 16-bit words in signed decimal. 

-X Interpret words in hex. 

The file argument specifies which file is to be dumped. If no file argument 
is specified, the standard input is used. 

The offset argument specifies the offset in the file where dumping is to com- 
mence. This argument is normally interpreted as octal bytes. If . is 
appended, the offset is interpreted in decimal. If b is appended, the offset is 
interpreted in blocks of 512 bytes. If the file argument is omitted, the offset 
argument must be preceded by +. 

Dumping continues until end-of-file. 
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NAME 

pack, peat, unpack - compress and expand files 

SYNOPSIS 

pack [ - ] [ ] name . . . 

peat name . . . 

unpack name ... 

DESCRIPTION 

The pack command attempts to store the specified files in a compressed 
form. Wherever possible (and useful), each input file name is replaced by a 
packed file name.z with the same access modes, access and modified dates, 
and owner as those of name. The -f option will force packing of name. 
This is useful for causing an entire directory to be packed even if some of 
the files will not benefit. If pack is successful, name will be removed. 
Packed files can be restored to their original form using unpack or peat. 

The pack command uses Huffman (minimum redundancy) codes on a byte- 
by-byte basis. If the - argument is used, an internal flag is set that causes 
the number of times each byte is used, its relative frequency, and the code 
for the byte to be printed on the standard output. Additional occurrences of 
- in place of name will cause the internal flag to be set and reset. 

The amount of compression obtained depends on the size of the input file 
and the character frequency distribution. Because a decoding tree forms the 
first part of each .z file, it is usually not worthwhile to pack files smaller 
than three blocks, unless the character frequency distribution is very 
skewed, which may occur with printer plots or pictures. 

Typically, text files are reduced to 60-75% of their original size. Load 
modules, which use a larger character set and have a more uniform distribu- 
tion of characters, show little compression, the packed versions being about 
90% of the original size. 

The pack command returns a value that is the number of files that it failed 
to compress. 

No packing will occur if: 

the file appears to be already packed; 

the file name has more than 12 characters; 

the file has links; 

the file is a directory; 

the file cannot be opened; 

no disk storage blocks will be saved by packing; 

a file called name.z already exists; 

the .z file cannot be created; 

an I/O error occurred during processing. 

The last segment of the file name must contain no more than 12 characters 
to allow space for the appended .z extension. Directories cannot be 
compressed. 
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The peat command does for packed files what cat{l) does for ordinary files, 
except that peat cannot be used as a filter. The specified files are unpacked 
and written to the standard output. Thus to view a packed file named 
name.z use: 

peat name.z 

or just: 

peat name 

To make an unpacked copy, say nnn, of a packed file named name.z 
(without destroying name.z), use the command: 

peat name >nnn 

The peat command returns the number of files it was unable to unpack. 
Failure may occur if: 

the file name (exclusive of the .z) has more than 12 characters; 
the file cannot be opened; 

the file does not appear to be the output of paek. 

Unpaek expands files created by paek. For each file name specified in the 
command, a search is made for a file called name.z (or just name, if name 
ends in .z). If this file appears to be a packed file, it is replaced by its 
expanded version. The new file has the .z suffix stripped from its name, 
and has the same access modes, access and modification dates, and owner 
as those of the packed file. 

Unpack returns a value that is the number of files it was unable to unpack. 
Failure may occur for the same reasons that it may in peat, as well as for 
the following: 

a file with the "unpacked" name already exists; 
if the unpacked file cannot be created. 

SEE ALSO 

cat(l). 
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NAME 

passmgmt - password files management 

SYNOPSIS 

passmgmt -a options name 
passmgmt -m options name 
passmgmt -d name 

DESCRIPTION 

The passmagmt command updates information in the password files. This 
command works with both /etc/passwd and /etc/shadow. If there is no 
shadow password file the changes done by passmgmt will go in 
/etc/passwd. 

passmgmt -a adds an entry for user name to the login password files. This 
command does not create any directory for the new user and the new login 
remains locked (with the string LK in the password field) until the 
passwd{lM) command is executed to set the password. 

passmgmt -m modifies the entry for user name in the login password files. 
The name field in the /etc/shadow entry and all the fields (except the pass- 
word field) in the /etc/password entry can be modified by this command. 
Only fields entered on the command line will be modified. If there is no 
/etc/shadow file, all modifications are made in /etc/passwd. 

passmgmt -d deletes the entry for user name from the login password files. 
It will not remove any files that the user owns on the system; they must be 
removed manually. 

name, the login name of the user, must be unique. 
The following options are available: 

-c comment A short description of the login. It is limited to a maximum of 
128 characters and defaults to an empty field. 

-h homedir Home directory of name. It is limited to a maximum of 256 
characters and defaults to /usr /name. 

-u uid UID of the name. This number must range from to the max- 

imum value for the system. It defaults to the next available 
UID greater than 100. Without the -o option, it enforces the 
uniqueness of a UID. 

-o This option allows a UID to be non-unique. It is used only 

with the -u option. 

-g gid GID of the name. This number must range from to the max- 

imum value for the system. The default is 1. 

-s shell Login shell for name. It should be the full pathname of the 
program that will be executed when the user logs in. The 
maximum length of shell is 256 characters. The default is for 
this field to be empty and to be interpreted as /bin/sh. 

-1 logname This option changes the name to logname for the -m option 
only. 
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The total size of each login entry, whether existing or new, is limited to a 
maximum of 511 bytes in the password files. 

FILES 

/etc/passwd 
/etc/shadow 
/etc/opasswd 
/etc/oshadow 

SEE ALSO 

passwd(l), passwd(lM). 

passwd(4) in the Programmer's Reference Manual. 
DIAGNOSTICS 

The passmgmt command exits with one of the following values: 

SUCCESS. 

1 Permission denied. 

2 Invalid command syntax. Usage message of the passmgmt com- 
mand will be displayed. 

3 Invalid argument provided to option. 

4 UID in use. 

5 Inconsistent password files (e.g., name is in the /etc/passwd file 
and not in the /etc/shadow file, or vice versa). 

6 Unexpected failure. Password files unchanged. 

7 Unexpected failure. Password file(s) missing. 

8 Password file(s) busy. Try again later. 

9 name does not exist (if -m or -d is specified), already exists (if -a 
is specified), or logname already exists (if -m -1 is specified). 

NOTE 

You cannot use a colon or <cr> because it will be interpreted as a field 
separator. 
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NAME 

passwd - change login password and password attributes 

SYNOPSIS 

passwd [name] 

passwd -s [name] 

passwd -1 [-f] [-X max] [-n min] name 
passwd -d [-£] [-x max] [-n min] name 
passwd -s [-a] 
DESCRIPTION 

The passwd command changes the password or lists password attributes 
associated with the user's login name. Additionally, super-users may use 
passwd to install or change passwords and attributes associated with any 
login name. (Options relating to password attributes are only available on 
systems using the /etc/shadow security feature.) 

When used to change a password, passwd prompts ordinary users for their 
old password, if any. It then prompts for the new password twice. When 
the old password is entered, passwd checks to see if it has "aged" suffi- 
ciently. If "aging" is insufficient, passwd terminates; see passwd{A). 

If the user's password aging has not been turned on, then password aging is 
turned on for the user using the MAXWEEK and MINWEEK parameters in 
/etc/default/passwd. If password aging is turned on, the password aging 
information in /etc/shadow remains unmodified. 

Assuming aging is sufficient, a check is made to ensure that the new pass- 
word meets construction requirements. When the new password is entered 
a second time, the two copies of the new password are compared. If the 
two copies are not identical the cycle of prompting for the new password is 
repeated for at most two more times. 

Passwords must be constructed to meet the following requirements: 

Each password must have at least PASSLENGTH characters as set 
in /etc/default/passwd. PASSLENGTH must contain a minimum 
of three characters, but only the first eight characters are significant. 

Each password must contain at least two alphabetic characters and 
at least one numeric or special character. In this case, "alphabetic" 
refers to all uppercase or lowercase letters. 

Each password must differ from the user's login name and any 
reverse or circular shift of that login name. For comparison pur- 
poses, an uppercase letter and its corresponding lowercase letter are 
equivalent. 

New passwords must differ from the old by at least three characters. 
For comparison purposes, an uppercase letter and its corresponding 
lowercase letter are equivalent. 

Super-users [e.g., real and effective uid equal to zero, see id{lM) and 
sw(lM)] may change any password; hence, passwd does not prompt super- 
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users for the old password. Super-users are not forced to comply with pass- 
word aging and password construction requirements. A super-user can 
create a null password by entering a carriage return in response to the 
prompt for a new password. (This differs from passwd -d because the 
" password " prompt will still be displayed.) 

Any user may use the -s option to show password attributes for the login 
name. 

The format of the display will be 

name status mm/dd/yy min max 

or, if password aging information is not present, 
name status 



FILES 



where: 

name The login ID of the user. 

status The password status of name: PS stands for passworded or 

locked, LK stands for locked, and NP stands for no password. 

mm/dd/yy The date password was last changed for name. 

min The minimum number of days required between password 

changes for name. 

max The maximum number of days the password is valid for name. 

Only a super-user can use the following options: 
-1 Locks password entry for name. 

-d Deletes password for name. The login name will not be 

prompted for password. 

-n Set minimum field for name. The min field contains the 

minimum number of days between password changes for name. 
Always use this option with the -x option (except when -x man 
is set to -1) to insure that aging is turned on. 

-X Set maximum field for name. The max field contains the number 

of days that the password is valid for name. The aging for name 
will be turned off immediately if max is set to -1. (Do not use 
with the -n option.) If it is set to 0, then the user is forced to 
change the password and aging is turned off at the next day's 
login session. 

-a Show password attributes for all entries. Use only with -s 

option; name must not be provided. 

-f Force the user to change password at the next login by expiring 

the password for name. 

/etc/passwd 
/etc/shadow 
/etc/opasswd 
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/etc/oshadow 

/etc /default /passwd 

SEE ALSO 

login(l), id(lM), passmgmt(lM), pwconv(lM), su(lM). 
crypt(3C), passwd(4) in the Programmer's Reference Manual 
DIAGNOSTICS 

The passwd command exits with one of the following values: 



SUCCESS. 

1 Permission denied. 

2 Invalid combination of options. 

3 Unexpected failure. Password file unchanged. 

4 Unexpected failure. Password file(s) missing. 

5 Password file(s) busy. Try again later. 

6 Invalid argument to option. 



WARNING 

If root deletes a password for a user with the passwd -d command, and 
password aging is in effect for that user, the user will not be allowed to add 
a new password until the NULL password has been aged. This is true even 
if the PASSREQ flag in /etc/login/default is set to YES. This results in a 
user without a password. It is recommended that the -f option be used 
whenever the -d (delete) option is used. This will force a user to change 
the password at next login. 
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NAME 

passwd - change login password and password attributes 

SYNOPSIS 

passwd [ name ] 

passwd -1 [ -f ] [ -X max ] [ -n min ] name 
passwd -d [ -f ] [ -X max ] [ -n min ] name 
passwd -s [ -a ] 
passwd -s [ name ] 
DESCRIPTION 

This command changes or installs login passwords and password attributes 
associated with the login name. The options to passwd are: 

-1 Locks password entry for name. 

-d Deletes password for name. The login name will not be prompted for 
password. 

-X Set maximum field for name. The max field contains the number of 
days that the password is valid for name. The aging for name will be 
turned off if max is set to 0. 

-n Set minimum field for name. The min field contains the minimum 
number of days between password changes for name. 

-s Shows password attributes for name. The format of the display will be: 

name status mm/dd/yy min max 

or, if password aging information is not present, 

name status 

name is the login ID of the user, status is the password status of name. 
PS stands for passworded or locked, LK stands for locked, and NP 
stands for no password, mm/dd/yy is the date password was last 
changed for name, min is the minimum number of days required 
between password changes for name, max is the maximum number of 
days the password is valid for name. 

-a Show password attributes for all entries. Use only with -s option; 
name must not be provided. 

-f Force the user to change password at the next login by expiring the 
password for name. 

Privileged users may change any password; hence, passwd does not prompt 
privileged users for the old password. Privileged users are not forced to 
comply with password aging and password construction requirements. A 
privileged user can create a null password by entering a carriage return in 
response to the prompt for a new password. 
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HLES 

/etc/passwd 

/etc/shadow 

/etc/opasswd 

/etc/oshadow 

/etc /default /passwd 

SEE ALSO 

id(lM), login(l), passmgmt(lM), passwd(l), su(lM). 
crypt(3C), passwd(4) in the Programmers Reference Manual. 
DIAGNOSTICS 

The passwd command exits with one of the following values: 



SUCCESS. 

1 Permission denied. 

2 Invalid combination of options. 

3 Unexpected failure. Password file unchanged. 

4 Unexpected failure. Password file missing. 

5 Password file(s) busy. Try again later. 

6 Invalid argument to option. 
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NAME 

paste - merge same lines of several files or subsequent lines of one file 

SYNOPSIS 

paste filel file2 ... 

paste -dlist filel file2 ... 

paste -s [-dlist] filel file2 ... 

DESCRIPTION 

In the first two forms, paste concatenates corresponding lines of the given 
input files filel, filel, etc. It treats each file as a column or columns of a 
table and pastes them together horizontally (parallel merging). If you will, 
it is the counterpart of cat{l) which concatenates vertically, i.e., one file 
after the other. In the last form above, paste replaces the function of an 
older command with the same name by combining subsequent lines of the 
input file (serial merging). In all cases, lines are glued together with the tab 
character, or with characters from an optionally specified list. Output is to 
the standard output, so it can be used as the start of a pipe, or as a filter, if 
- is used in place of a file name. 

The meanings of the options are: 

-d Without this option, the new-line characters of each but the last file 
(or last line in case of the -s option) are replaced by a tab character. 
This option allows replacing the tab character by one or more alter- 
nate characters (see below). 

list One or more characters immediately following -d replace the 
default tab as the line concatenation character. The list is used cir- 
cularly, i.e., when exhausted, it is reused. In parallel merging (i.e., 
no -s option), the lines from the last file are always terminated with 
a new-line character, not from the list. The list may contain the 
special escape sequences: \n (new-line), \t (tab), \ (backslash), and 
\0 (empty string, not a null character). Quoting may be necessary, 
if characters have special meaning to the shell (e.g., to get one 
backslash, use -d "\\" ). 

-s Merge subsequent lines rather than one from each input file. Use 
tab for concatenation, unless a list is specified with -d option. 
Regardless of the list, the very last character of the file is forced to 
be a new-line. 

May be used in place of any file name, to read a line from the stan- 
dard input. (There is no prompting). 

EXAMPLES 

Is I paste -d " " - list directory in one column 

Is I paste list directory in four columns 

paste -s -d " \ t\ n " file combine pairs of lines into lines 

SEE ALSO 

cut(l), grep(l), pr(l). 
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DIAGNOSTICS 

line too long Output lines are restricted to 511 characters. 

too many files Except for -s option, no more than 12 input files 

may be specified. 



- 2 - 



PG(1) 



(Editing Package) 



PG(1) 



NAME 

pg - file perusal filter for CRTs 
SYNOPSIS 

pg [ - number] [-p string] [-cefns] [ + linenumber] [ +/ pattern / ] 
[files ...] 

DESCRIPTION 

The pg command is a filter which allows the examination of files one 
screenful at a time on a CRT. (The file name - and/or NULL arguments 
indicate that pg should read from the standard input.) Each screenful is fol- 
lowed by a prompt. If the user types a carriage return, another page is 
displayed; other possibilities are enumerated below. 

This command is different from previous paginators in that it allows you to 
back up and review something that has already passed. The method for 
doing this is explained below. 

In order to determine terminal attributes, pg scans the terminfo(4t) data base 
for the terminal type specified by the environment variable TERM. If TERM 
is not defined, the terminal type dumb is assumed. 

The command line options are: 

-number 

An integer specifying the size (in lines) of the window that pg is to 
use instead of the default. (On a terminal containing 24 lines, the 
default window size is 23). 

-p string 

Causes pg to use string as the prompt. If the prompt string contains 
a "%d", the first occurrence of ''%d" in the prompt will be replaced 
by the current page number when the prompt is issued. The default 
prompt string is 

-c Home the cursor and clear the screen before displaying each page. 
This option is ignored if clear-.screen is not defined for this termi- 
nal type in the terminfo(4) data base. 

-e Causes pg not to pause at the end of each file. 

-f Normally, pg splits lines longer than the screen width, but some 
sequences of characters in the text being displayed (e.g., escape 
sequences for underlining) generate undesirable results. The -/ 
option inhibits pg from splitting lines. 

-n Normally, commands must be terminated by a <newline> character. 
This option causes an automatic end of command as soon as a com- 
mand letter is entered. 

-s Causes pg to print all messages and prompts in standout mode (usu- 
ally inverse video). 

■hlinenumber 

Start up at linenumber . 

+ /pattern / 

Start up at the first line containing the regular expression pattern. 
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The responses that may be typed when pg pauses can be divided into three 
categories: those causing further perusal, those that search, and those that 
modify the perusal environment. 

Commands which cause further perusal normally take a preceding address, 
an optionally signed number indicating the point from which further text 
should be displayed. This address is interpreted in either pages or lines 
depending on the command. A signed address specifies a point relative to 
the current page or line, and an unsigned address specifies an address rela- 
tive to the beginning of the file. Each command has a default address that 
is used if none is provided. 

The perusal commands and their defaults are as follows: 

(-\-l)<newline> or <blank> 

This causes one page to be displayed. The address is specified in 
pages. 

(-f 1) 1 With a relative address, this causes pg to simulate scrolling the 
screen, forward or backward, the number of lines specified. With 
an absolute address, this command prints a screenful beginning at 
the specified line. 

(+1) d or 'D 

Simulates scrolling half a screen forward or backward. 
The following perusal commands take no address . 

. or L Typing a single period causes the current page of text to be 
redisplayed. 

$ Displays the last windowful in the file. Use with caution when the 

input is a pipe. 

The following commands are available for searching for text patterns in the 
text. The regular expressions described in ed{l) are available. They must 
always be terminated by a <newline>, even if the -n option is specified. 

i I pattern I 

Search forward for the ith (default z=l) occurrence of pattern. 
Searching begins immediately after the current page and continues 
to the end of the current file, without wrap-around. 

I pattern 
ilpattern? 

Search backwards for the zth (default /=1) occurrence of pattern. 
Searching begins immediately before the current page and continues 
to the beginning of the current file, without wrap-around. The 
notation is useful for Adds 100 terminals which will not properly 
handle the ?. 

After searching, pg will normally display the line found at the top of the 
screen. This can be modified by appending m or b to the search command 
to leave the line found in the middle or at the bottom of the window from 
now on. The suffix t can be used to restore the original situation. 
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The user of pg can modify the environment of perusal with the following 
commands: 

in Begin perusing the zth next file in the command line. The / is an 
unsigned number, default value is 1. 

fp Begin perusing the fth previous file in the command line. / is an 
unsigned number, default is 1 . 

fw Display another window of text. If i is present, set the window size 
to I. 

s filename 

Save the input in the named file. Only the current file being 
perused is saved. The white space between the s and filename is 
optional. This command must always be terminated by a <nezv- 
line>, even if the -n option is specified. 

h Help by displaying an abbreviated summary of available commands. 

qorQ Quit;?^. 

{command 

Command is passed to the shell, whose name is taken from the 
SHELL environment variable. If this is not available, the default 
shell is used. This command must always be terminated by a 
<newline>, even if the -n option is specified. 

At any time when output is being sent to the terminal, the user can hit the 
quit key (normally control-\) or the interrupt (break) key. This causes j)g to 
stop sending output, and display the prompt. The user may then enter one 
of the above commands in the normal manner. Unfortunately, some output 
is lost when this is done, due to the fact that any characters waiting in the 
terminal's output queue are flushed when the quit signal occurs. 

If the standard output is not a terminal, then pg acts just like cat{\), except 
that a header is printed before each file (if there is more than one). 

EXAMPLE 

A sample usage of pg in reading system news would be 
news I pg -p " (Page %d): " 

NOTES 

While waiting for terminal input, pg responds to BREAK, DEL, and * by ter- 
minating execution. Between prompts, however, these signals interrupt pg's 
current task and place the user in prompt mode. These should be used with 
caution when input is being read from a pipe, since an interrupt is likely to 
terminate the other commands in the pipeline. 

Users of Berkeley's more will find that the z and f commands are available, 
and that the terminal /, \ or ? may be omitted from the searching com- 
mands. 
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FILES 

/usr/lib/terminfo/?/* terminal information database 

/tmp /pg* temporary file when input is from a pipe 

SEE ALSO 

ed(l), grep(l). 

terminfo(4) in the Programmer's Reference Manual . 

BUGS 

If terminal tabs are not set every eight positions, undesirable results may 
occur. 

When using pg as a filter with another command that changes the terminal 
I/O options, terminal settings may not be restored correctly. 
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NAME 

pr - print files 
SYNOPSIS 

pr [[-column] [-wwidth] [-a]] [-eck] [-ick] [-drtfp] [+page] [-nek] 
[-ooffset] [-Uength] [-sseparator] [-hheader] [file ...] 

pr [[-m] [-wwidth]] [-eck] [-ick] [-drtfp] [+page] [-nek] [-ooffset] 
[-Uength] [-sseparator] [-hheader] filel file2 ... 

DESCRIPTION 

pr is used to format and print the contents of a file. If file is -, or if no files 
are specified, pr assumes standard input, pr prints the named files on stan- 
dard output. 

By default, the listing is separated into pages, each headed by the page 
number, the date and time that the file was last modified, and the name of 
the file. Page length is 66 lines, which includes 10 lines of header and 
trailer output. The header is composed of 2 blank lines, 1 line of text ( can 
be altered with -h), and 2 blank lines; the trailer is 5 blank lines. For sin- 
gle column output, line width may not be set and is unlimited. For multi- 
column output, line width may be set and the default is 72 columns. Diag- 
nostic reports (failed options) are reported at the end of standard output 
associated with a terminal, rather than interspersed in the output. Pages are 
separated by series of line feeds rather than form feed characters. 

By default, columns are of equal width, separated by at least one space; 
lines which do not fit are truncated. If the -s option is used, lines are not 
truncated and columns are separated by the separator character. 

Either -column or -m should be used to produce multi-column output, -a 
should only be used with -column and not -m. 

Command line options are: 

+page Begin printing with page numbered page (default is 1). 

-column Print column columns of output (default is 1). Output appears as 
if -e and -i are turned on for multi-column output. May not use 
with -m. 

-a Print multi-column output across the page one line per column. 

columns must be greater than one. If a line is too long to fit in a 
column, it is truncated. 

-m Merge and print all files simultaneously, one per column. The 

maximum number of files that may be specified is eight. If a line 
is too long to fit in a column, it is truncated. May not use with 
-column, 

-d Double-space the output. Blank lines that result from double- 

spacing are dropped when they occur at the top of a page. 

-eck Expand input tabs to character positions k+l, 2*k-\-l, 3*k+l, etc. 

If is or is omitted, default tab settings at every eighth posi- 
tion are assumed. Tab characters in the input are expanded into 
the appropriate number of spaces. If c (any non-digit character) 
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is given, it is treated as the input tab character (default for c is 
the tab character). 

ick In output, replace white space wherever possible by inserting 

tabs to character positions /c+1, 2*A:+1, 3*A:+1, etc. If ^ is or is 
omitted, default tab settings at every eighth position are 
assumed. If c (any non-digit character) is given, it is treated as 
the output tab character (default for c is the tab character). 

nek Provide /: -digit line numbering (default for is 5). The number 

occupies the first k+1 character positions of each column of sin- 
gle column output or each line of -m output. If c (any non-digit 
character) is given, it is appended to the line number to separate 
it from whatever follows (default for c is a tab). 

wwidth Set the width of a line to width character positions (default is 
72). This is effective only for multi-column output (-column and 
-m). There is no line limit for single column output. 

ooffset Offset each line by offset character positions (default is 0). The 
number of character positions per line is the sum of the width 
and offset. 

Set the length of a page to length lines (default is 66). -10 is 
reset to -166. When the value of length is 10 or less, -t appears 
to be in effect since headers and trailers are suppressed. By 
default, output contains 5 lines of header and 5 lines of trailer 
leaving 56 lines for user-supplied text. When -llength is used 
and length exceeds 10, then length-10 lines are left per page for 
user-supplied text. When length is 10 or less, header and trailer 
output is omitted to make room for user-supplied text. 

Use header as the text line of the header to be printed instead of 
the file name, -h is ignored when -t is specified or Alength is 
specified and the value of length is 10 or less, (-h is the only pr 
option requiring space between the option and argument.) 

Pause before beginning each page if the output is directed to a 
terminal (pr will ring the bell at the terminal and wait for a car- 
riage return). 

Use single form-feed character for new pages (default is to use a 
sequence of line-feeds). Pause before beginning the first page if 
the standard output is associated with a terminal. 

Print no diagnostic reports on files that will not open. 

Print neither the five-line identifying header nor the five-line 
trailer normally supplied for each page. Quit printing after the 
last line of each file without spacing to the end of the page. Use 
of -t overrides the -h option. 

sseparator 

Separate columns by the single character separator instead of by 
the appropriate number of spaces (default for separator is a tab). 
Prevents truncation of lines on multi-column output unless -w is 
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specified. 



EXAMPLES 

Print filel and file2 as a double-spaced, three-column listing headed by 
"file list": 

pr -3dh "file list" filel file2 

Copy filel to file2, expanding tabs to columns 10, 19, 28, 37, ... : 
pr -e9 -t <filel >file2 

Print filel and file2 simultaneously in a two-column listing with no header 
or trailer where both columns have line numbers: 

pr -t -n filel I pr -t -m -n file2 



FILES 



/dev/tty* 



If standard output is directed to one of the special files 
/dev/tty*, then other output directed to this terminal is 
delayed until standard output is completed. This prevents 
error messages from being interspersed throughout the out- 
put. 



SEE ALSO 



cat(l), pg(l). 
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NAME 

profiler: prfld, prfstat, prfdc, prfsnap, prfpr - UNIX system profiler 

SYNOPSIS 

/etc/prfld [ system_namelist ] 
/etc/prfstat on 
/etc/prfstat off 

/etc/prfdc file [ period [ off—hour ] ] 
/etc/prfsnap file 

/etc/prfpr file [ cutoff [ system_namelist ] ] 
DESCRIPTION 

The prfld, prfstat, prfdc, prfsnap, and prfpr routines form a system of pro- 
grams to facilitate an activity study of the UNIX operating system. 

The prfld program is used to initialize the recording mechanism in the sys- 
tem. It generates a table containing the starting address of each system sub- 
routine as extracted from system— namelist . 

The prfstat program is used to enable or disable the sampling mechanism. 
Profiler overhead is less than 1% as calculated for 500 text addresses. 
Prfstat v^ill also reveal the number of text addresses being measured. 

The prfdc and prfsnap programs perform the data collection function of the 
profiler by copying the current value of all the text address counters to a file 
where the data can be analyzed. Prfdc will store the counters into file every 
period minutes and will turn off at off— hour (valid values for off— hour are 
0-24). Prfsnap collects data at the time of invocation only, appending the 
counter values to file. 

The prfpr program formats the data collecfed by prfdc or prfsnap. Each text 
address is converted to the nearest text symbol (as found in 
system— namelist) and is printed if the percent activity for that range is 
greater than cutoff. 

FILES 

/dev/prf interface to profile data and text addresses 

/unix default for system namelist file 
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NAME 

ps - report process status 

SYNOPSIS 

ps [options] 

DESCRIPTION 

ps prints certain information about active processes. Without options, infor- 
mation is printed about processes associated with the controlling terminal. 
Output consists of a short listing containing only the process ID, terminal 
identifier, cumulative execution time, and the command name. Otherwise, 
the information that is displayed is controlled by the selection of options. 

Options accept names or lists as arguments. Arguments can be either 
separated from one another by commas or enclosed in double quotes and 
separated from one another by commas or spaces. Values for proclist and 
grplist must be numeric. 

The options are given in descending order according to volume and range of 
information provided: 

-e Print information about every process now running, 

-d Print information about all processes except process group 

leaders. 

-a Print information about all processes most frequently 

requested: all those except process group leaders and 

processes not associated with a terminal, 
-f Generate a full listing. (See below for significance of columns 

in a full listing.) 
-1 Generate a long listing. (See the following text.) 

-n name Valid only for users with a real user id of root or a real group 

id of sys. Takes argument signifying an alternate system name 

in place of /unix. 

-t termlist List only process data associated with the terminal given in 
termlist. Terminal identifiers may be specified in one of two 
forms: the device's file name (e.g., tty04) or, if the device's file 
name starts with tty, just the digit identifier (e.g., 04). 

-p proclist List only process data whose process ID numbers are given in 
proclist. 

-u uidlist List only process data whose user ID number or login name is 
given in uidlist. In the listing, the numerical user ID will be 
printed unless you give the -f option, which prints the login 
name. 

-g grplist List only process data whose process group leader's ID 
number(s) appears in grplist. (A group leader is a process 
whose process ID number is identical to its process group ID 
number. A login shell is a common example of a process 
group leader.) 

Under the -f option, ps tries to determine the command name and argu- 
ments given when the process was created by examining the user block. 
Failing this, the command name is printed, as it would have appeared 
without the -f option, in square brackets. 
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The column headings and the meaning of the columns in a ps listing are 
given in the following text; the letters f and 1 indicate the option (full or 
long, respectively) that causes the corresponding heading to appear; all 
means that the heading always appears. Note that these two options deter- 
mine only what information is provided for a process; they do not deter- 
mine which processes will be listed. 

F (1) Flags (hexadecimal and additive) associated with the pro- 

cess 

00 Process has terminated: process table entry now 
available. 

01 A system process: always in primary memory. 

02 Parent is tracing process. 

04 Tracing parent's signal has stopped process: 
parent is waiting [ptrace{2)]. 

08 Process is currently in primary memory. 
10 Process currently in primary memory: locked 
until an event completes. 

S (1) The state of the process: 

Process is running on a processor. 

5 Sleeping: process is waiting for an event to com- 
plete. 

R Runnable: process is on run queue. 

1 Idle: process is being created. 

Z Zombie state: process terminated and parent not 
waiting. 

T Traced: process stopped by a signal because 
parent is tracing it. 

X SXBRK state: process is waiting for more primary 
memory. 



UID 


(f,l) 


The user ID number of the process owner (the login 
name is printed under the -f option). 


FID 


(all) 


The process ID of the process (this datum is necessary in 
order to kill a process). 


PPID 


(f,l) 


The process ID of the parent process. 


C 


(f.l) 


Processor utilization for scheduling. 


PRI 


(1) 


The priority of the process (higher numbers mean lower 
priority). 


NI 


(1) 


Nice value, used in priority computation. 


ADDR 


(1) 


The memory address of the process. 


SZ 


(1) 


The size (in pages or clicks) of the swappable process's 
image in main memory. 
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WCHAN (1) The address of an event for which the process is sleep- 
ing, or in SXBRK state, (if blank, the process is running). 

(f) The starting time of the process, given in hours, minutes, 
and seconds. (A process begun more than twenty-four 
hours before the ps inquiry is executed is given in 
months and days.) 

(all) The controlling terminal for the process (the message, ?, 
is printed when there is no controlling terminal). 

(all) The cumulative execution time for the process. 

COMMAND (all) The command name (the full command name and its 
arguments are printed under the -f option). 

A process that has exited and has a parent, but has not yet been waited for 
by the parent, is marked <defunct>. 



STIME 



TTY 



TIME 



FILES 



terminal ("tty'') names searcher files 
kernel virtual memory 
the default swap device 
memory 

UID information supplier 
internal data structure 
system name list 



/dev 

/dev/sxt/* 
/dev/tty* 
/dev/xt/* 
/dev/kmem 
/dev/swap 
/dev/mem 
/etc/passwd 
/etc/ps_data 
/unix 

SEE ALSO 

getty(lM), kill(l), nice(l). 

WARNING 

Things can change while ps is running; the snap-shot it gives is only true 
for a split-second, and it may not be accurate by the time you see it. Some 
data printed for defunct processes is irrelevant. 

If no termlist, proclist, uidlist, or grplist is specified, ps checks stdin, stdout, 
and stderr in that order, looking for the controlling terminal and will 
attempt to report on processes associated with the controlling terminal. In 
this situation, if stdin, stdout, and stderr are all redirected, ps will not find a 
controlling terminal, so there will be no report. 

On a heavily loaded system, ps may report an lseek(2) error and exit, ps 
may seek to an invalid user area address: having obtained the address of a 
process' user area, ps may not be able to seek to that address before the 
process exits and the address becomes invalid. 

ps -ef may not report the actual start of a tty login session, but rather an 
earlier time, when a getty was last respawned on the tty line. 
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NAME 

pwck, grpck - password/group file checkers 

SYNOPSIS 

/etc/pwck [file] 
/etc/grpck [file] 

DESCRIPTION 

The pwck command scans the password file and notes any inconsistencies. 
The checks include validation of the number of fields, login name, user ID, 
group ID, and whether the login directory and the program-to-use-as-Shell 
exist. The default password file is /etc/pass wd. 

The grpck command verifies all entries in the group file. This verification 
includes a check of the number of fields, group name, group ID, and 
whether all login names appear in the password file. The default group file 
is /etc/group. 

FILES 

/etc/group 
/etc/passwd 

SEE ALSO 

group(4), passwd(4) in the Programmer's Reference Manual. 
DIAGNOSTICS 

Group entries in /etc/group with no login names are flagged. 
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NAME 

pwconv - install and update /etc/shadow with information from 
/etc/passwd 

SYNOPSIS 

pwconv 

DESCRIPTION 

The pwconv command creates and updates /etc/shadow with information 
from /etc/passwd. If the /etc/shadow file does not exist, this command 
will create /etc/shadow with information from /etc/passwd. The com- 
mand populates /etc/shadow with the user's login name, password, and 
password aging information. If password aging information does not exist 
in /etc/passwd for a given user, none will be added to /etc/shadow. 
However, the "last changed" information will always be updated. 

If the /etc/shadow file does exist, the following tasks will be performed: 

Entries that are in the /etc/passwd file and not in the /etc/shadow 
file will be added to the /etc/shadow file. 

Entries that are in the /etc/shadow file and not in the /etc/passwd 
file will be removed from /etc/shadow. 

Password attributes (e.g., password and aging information) that exist 
in an /etc/passwd entry will be moved to the corresponding entry 
in /etc/shadow. 

The following is the format of an entry in /etc/passwd: 

name:passwd,aging:uid:gid:comment:homedir:shell 

The following table shows how changes made to /etc/passwd affect 
/etc/shadow when pwconv is run: 

name delete old entry from /etc/shadow, 

add new entry to /etc/shadow 

passwd update password and aging fields in /etc/shadow, 

place an x in /etc/passwd 

aging update aging fields in /etc/shadow, 

clear aging field in /etc/passwd 

remaining fields ignore — no change to /etc/shadow 

The pwconv program is a privileged system command that cannot be exe- 
cuted by ordinary users. The passwd command should be used to add or 
change password aging information or passwords. 

FILES 

/etc/passwd 
/etc/shadow 
/etc/opasswd 
/etc/oshadow 
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SEE ALSO 

'•passwd(lM), passmgmt(lM). 

DIAGNOSTICS 

The pwconv command exits with one of the following values: 



SUCCESS. 

1 Permission denied. 

2 Invalid command syntax. 

3 Unexpected failure. Conversion not done. 

4 Unexpected failure. Password file(s) missing. 

5 Password file(s) busy. Try again later. 
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NAME 

pwd - working directory name 

SYNOPSIS 

pwd 

DESCRIPTION 

The pwd command prints the path name of the working (current) directory. 

SEE ALSO 

cd(l). 
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NAME 

random - generate a random number 

SYNOPSIS 

random [-s] [ scale ] 

DESCRIPTION 

The random command generates a random number, scale, on the standard 
output and returns the number as its exit value. By default, this number is 
either or 1. If scale is given a value between 1 and 255, then the range of 
the random value is from to scale. If scale is greater than 255, an error 
message is printed. 

When the -s (silent) option is given, then the random number is returned as 
an exit value but is not printed on the standard output. If an error occurs, 
random returns an exit value of zero. 

SEE ALSO 

rand(3C) in the Programmer's Reference Manual . 

NOTES 

This command does not perform any floating-point computations. 
random uses the time of day as a seed. 
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NAME 

rcO - run commands performed to stop the operating system 

SYNOPSIS 

/etc/rcO 

DESCRIPTION 

This file is executed at each system state change that needs to have the sys- 
tem in an inactive state. It is responsible for those actions that bring the 
system to a quiescent state, traditionally called "shutdown/' 

One system state requires this procedure: state (the system halt state). 
Whenever a change to this state occurs, the /etc/rcO procedure is run. The 
entry in /etc/inittab might read: 

sO:0:wait:/etc/rcO >/dev/console 2>&1 </dev/console 

Some of the actions performed by /etc/rcO are carried out by files in the 
directory /etc/shutdown.d. and files beginning with K in /etc/rcO.d. 
These files are executed in ASCII order (see FILES below for more informa- 
tion), terminating some system service. The combination of commands in 
/etc/rcO and files in /etc/shutdown.d and /etc/rcO.d determines how the 
system is shut down. 

The recommended sequence for /etc/rcO is: 

Stop System Services and Daemons. 

Various system services (such as Remote File Sharing or LP Spooler) 
are gracefully terminated. 

When new services are added that should be terminated when the 
system is shut down, the appropriate files are installed in 
/etc/shutdown.d and /etc/rcO.d. 

Terminate Processes 

SIGTERM signals are sent to all running processes by killall(lM). 
Processes stop themselves cleanly if sent SIGTERM. 

Kill Processes 

SIGKILL signals are sent to all remaining processes; no process can 
resist SIGKILL. 

At this point the only processes left are those associated with 
/etc/rcO and processes and 1, which are special to the operating 
system. 

Unmount All File Systems 

Only the root file system (/) remains mounted. 

FILES 

The execution by /bin/sh of any files in /etc/shutdown.d occurs in ASCII 
sort-sequence order. See rc2 (IM) for more information. 



- 1 - 



RCO(IM) (Base System) RCO(IM) 



SEE ALSO 

killall(lM), rc2(lM), shutdown(lM). 



-2 - 



RC2(1M) (Base System) RC2(1M) 



NAME 

rc2 - run commands performed for multiuser environment 

SYNOPSIS 

/etc/rc2 

DESCRIPTION 

This file is executed via an entry in /etc/inittab and is responsible for those 
initializations that bring the system to a ready-to-use state, traditionally 
state 2, called the "multiuser" state. 

The actions performed by /etc/rcl are found in files in the directory 
/etc/red and files beginning with S in /etc/rc2.d. These files are executed 
by /bin/sh in ASCII sort-sequence order (see FILES for more information). 
When functions are added that need to be initialized when the system goes 
multiuser, an appropriate file should be added in /etc/rc2.d. 

The functions done by / etc/rcl command and associated /etc/rc2.d files 
include: 

Setting and exporting the TIMEZONE variable. 

Setting up and mounting the user (/usr) file system. 

Cleaning up (remaking) the /tmp and /usr/tmp directories. 

Loading the network interface and ports cards with program data 
and starting the associated processes. 

Starting the cron daemon by executing /etc/cron. 

Cleaning up (deleting) uucp locks status and temporary files in the 
/usr/spool/uucp directory. 

Other functions can be added, as required, to support the addition of 
hardware and software features. 

EXAMPLES 

The following are prototypical files found in /etc/rc2.d. These files are pre- 
fixed by an S and a number indicating the execution order of the files. 

MOUNTFILESYS 

# Set up and mount file systems 
cd / 

/etc/mountall /etc/fstab 

RMTMPFILES 

# clean up /tmp 
rm -rf /tmp 
mkdir /tmp 
chmod 777 /tmp 
chgrp sys /tmp 
chown sys /tmp 

uucp 
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# clean-up uucp locks, status, and temporary files 
rm -rf /usr/spool/locks/* 

The file /etc/TIMEZONE is included early in /etc/rcl, thus establishing 
the default time zone for all commands that follow. 

FILES 

Here are some hints about files in /etc/red: 

The order in which files are executed is important. Since they are executed 
in ASCII sort-sequence order, using the first character of the file name as a 
sequence indicator will help keep the proper order. Thus, files starting with 
the following characters would be: 

[0-9]. very early 

[A-Z]. early 

[a-n]. later 

[o-zj. last 

3.mountfs 

Files in /etc/red that begin with a dot (.) will not be executed. This 
feature can be used to hide files that are not to be executed for the time 
being without removing them. The command can be used only by the 
super-user. 

Files in /etc/rc2.d must begin with an S or a K followed by a number and 
the rest of the file name. Upon entering run level 2, files beginning with S 
are executed with the start option; files beginning with K are executed with 
the stop option. Files beginning with other characters are ignored. 

SEE ALSO 

shutdown(lM). 
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NAME 

relogin - rename login entry to show current layer 

SYNOPSIS 

/usr/lib/layersys/relogin [-s] [line] 

DESCRIPTION 

The relogin command changes the terminal line field of a user's utmp(^) 
entry to the name of the windowing terminal layer attached to standard 
input. write(l) messages sent to this user are directed to this layer. In addi- 
tion, the who(l) command will show the user associated with this layer. 
The relogin command may only be invoked under layers(l). 

relogin is invoked automatically by layers(l) to set the utmp(4) entry to the 
terminal line of the first layer created upon startup and to reset the utmp(4) 
entry to the real line on termination. It may be invoked by a user to desig- 
nate a different layer to receive write(l) messages. 

-s Suppress error messages. 

line Specifies which utmp{4:) entry to change. The utmp(4:) file is 
searched for an entry with the specified line field. That field is 
changed to the line associated with the standard input. To learn 
what lines are associated with a given user, say jdoe, type: 

ps -f -u jdoe 

and note the values shown in the TTY field [see ps(l)]. 

FILES 

/etc/utmp data base of users versus terminals 

EXIT STATUS 

Returns upon successful completion, 1 otherwise. 

SEE ALSO 

layers(l), mesg(l), ps(l), who(l), write(l). 
utmp(4) in the Programmer's Reference Manual. 

NOTES 

If line does not belong to the user issuing the relogin command or standard 
input is not associated with a terminal, relogin will fail. 
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NAME 

removepkg - remove installed package 

SYNOPSIS 

removepkg [software—package] 

DESCRIPTION 

The removepkg command will remove the software package specified as an 
argument to removepkg or will remove the software package the user selects 
if no argument is given to removepkg. 

If an argument is specified, removepkg will search the list of previously 
installed packages and remove the first name it matchs. If no name is 
matched, the user is given an error message. 

If no argument is specified, removepkg will query the user, via a menu, 
which package to remove. 

You will need to be root to remove some packages. 

LIMITATIONS 

You must invoke removepkg on the console. 

SEE ALSO 

displaypkg(l), installpkg(l). 
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NAME 

restore - restore file to original directory 
SYNOPSIS 

restore [-c] [-i] [-o] [-t] [-d <device>] [pattern [pattern]...] 
DESCRIPTION 

-c complete restore. All files on the tape are restored. 

-i gets the index file off of the medium. This only works when the 
archive was created using backup. The output is a list of all the files 
on the medium. No files are actually restored. 

-o overwrite existing files. If the file being restored already exists it 
will not be restored unless this option is specified. 

-t indicates that the tape device is to be used. MUST be used with the 
-d option when restoring from tape. 

-d <device> is the raw device to be used. It defaults to 
/dev/rdsk/f0ql5d (the 1.2M floppy). 

When doing a restore, one or more patterns can be specified. These pat- 
terns are matched against the files on the tape. When a match is found, the 
file is restored. Since backups are done using full pathnames, the file is 
restored to its original directory. Metacharacters can be used to match mul- 
tiple files. The patterns should be in quotes to prevent the characters from 
being expanded before they are passed to the command. If no patterns are 
specified, it defaults to restoring all files. If a pattern does not match any 
file on the tape, a message is printed. 

When end of medium is reached, the user is prompted for the next media. 
The user can exit at this point by typing "q". (This may cause files to be 
corrupted if a file happens to span a medium.) In general, quitting in the 
middle is not a good idea. 

If the file already exists and an attempt is made to restore it without the -o 
option, the file name will be printed on the screen followed by a question 
mark. This file will not be restored. 

In order for multi-volume restores to work correctly, the raw device MUST 
be used. 

SEE ALSO 

qt(7), sh(l). 
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NAME 

rfadmin - Remote File Sharing administration 

SYNOPSIS 

rfadmin 

rfadmin -[ar] domain. nodename 
rfadmin -[pq] 
rfadmin -o option 
DESCRIPTION 

rfadmin is primarily used to add and remove computers and their associated 
authentication information from a domain /pa.sswd file on a Remote File 
Sharing primary domain name server. It is also used to transfer domain 
name server responsibilities from one machine to another. Used with no 
options, rfadmin returns the domain. nodename of the current domain name 
server for the local domain. Other options let you check if RFS is running 
and turn on the RFS loop back feature. 

rfadmin can only be used to modify domain files on the primary domain 
name server (-a and -r options). If domain name server responsibilities are 
temporarily passed to a secondary domain name server, that computer can 
use the -p option to pass domain name server responsibility back to the pri- 
mary, rfadmin can be used on any computer with no options or with the q 
or o options. To print information about the current domain name server, 
the user must have root permissions to use the command. 

-a domain.nodename Used to add a computer to the member list of the 
domain that is served by this primary domain name 
server. The computer's name must be of the form 
domain.nodename . This command creates an entry for 
nodename in the domain /p^ssvfd file, which has the 
same format as /etc/passwd, and prompts for an ini- 
tial authentication password. The password prompting 
process conforms with that of passwd{l). 

-r domain.nodename Used to remove a computer from its domain by 
removing it from the domain /psisswd file. 

-p Used to pass the domain name server responsibilities 

back to a primary or to a secondary name server. 

-q Prints a message that will tell you whether or not RFS 

is running. 

-o option Lets you set RFS system options, by replacing option 

with one of the following: 

loopback - Enables loop back facility for your com- 
puter. When this is set, you can mount a resource that 
is advertised from your own computer. This is used 
for testing applications in RFS when only one com- 
puter is available. Loop back is off by default. 
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noloopback - Turns off the loop back facility for your 
computer. This is the default. 

ERRORS 

When used with the -a option, if domain.nodename is not unique in the 
domain, an error message will be sent to standard error. 

When used with the -r option, if (1) domain.nodename does not exist in the 
domain, (2) domain.nodename is defined as a domain name server, or (3) 
there are resources advertised by domain.nodename, an error message will be 
sent to standard error. 

When used with the -p option to change the domain name server, if there 
are no backup name servers defined for domain, a warning message will be 
sent to standard error. 

FILES 

/usr/nserve/auth.info/rfomaftt/passwd 
(This file should be created on the primary for each 
domain. It should then be copied to all secondaries 
and to all computers doing password verification for 
that domain.) 

SEE ALSO 

passwd(l), rfstart(lM), rfstop(lM), umount(lM). 
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NAME 

rfpasswd - change Remote File Sharing host password 

SYNOPSIS 

rfpasswd 

DESCRIPTION 

The rfpasswd command updates the Remote File Sharing authentication 
password for a host; processing of the new password follows the same cri- 
teria as passwd{l). The updated password is registered at the domain name 
server (/usr/nserve/auth.info/rfomflfn/passwd) and replaces the password 
stored at the local host (/usr/nserve/loc.passwd file). 

This command is restricted to the super-user. 

NOTE: If you change your host password, make sure that hosts that vali- 
date your password are notified of this change. To receive the new pass- 
word, hosts must obtain a copy of the domain /pSLSSwd file from the 
domain's primary name server. If this is not done, attempts to mount 
remote resources may fail! 

ERRORS 

If (1) the old password entered from this command does not match the 
existing password for this machine, (2) the two new passwords entered from 
this command do not match, (3) the new password does not satisfy the 
security criteria in passwd(l), (4) the domain name server does not know 
about this machine, or (5) the command is not run with super-user 
privileges, an error message will be sent to standard error. Also, Remote 
File Sharing must be running on your host and your domain's primary 
name server. A new password cannot be logged if a secondary is acting as 
the domain name server. 

FILES 

/usr /nserve /auth.info / domain /passwd 
/usr /nserve /loc.passwd 

SEE ALSO 

passwd(l), rfstart(lM), rfadmin(lM). 



- 1 - 



RFSTART(IM) 



(Remote File Sharing Utilities) 



RFSTART(IM) 



NAME 

rfstart - start Remote File Sharing 

SYNOPSIS 

rfstart [-v] [-pprimary_addr] 

DESCRIPTION 

The rfstart command starts Remote File Sharing and defines an authentica- 
tion level for incoming requests. [This command can only be used after the 
domain name server is set up and your computer's domain name and net- 
work specification has been defined using dname{lM).] 

-V Specifies that verification of all clients is required in response to 
initial incoming mount requests; any host not in the file 
/usr/nserve/auth.info/t^omflf«/passwd for the domain they 
belong to will not be allowed to mount resources from your host. 
If -V is not specified, hosts named in domain/pSLSSwd will be veri- 
fied, and other hosts will be allowed to connect without verifica- 
tion. 

-p primary— addr 

Indicates the primary domain name server for your domain. 
primary— addr must be the network address of the primary name 
server for your domain. If the -p option is not specified, the 
address of the domain name server is taken from the rfmaster file. 
[See rfmaster(4) for a description of the valid address syntax.] 

If the host password has not been set, rfstart will prompt for a password; 
the password prompting process must match the password entered for your 
machine at the primary domain name server [see rfadmin{lM)]. If you 
remove the loc.passwd file or change domains, you will also have to 
reenter the password. 

Also, when rfstart is run on a domain name server, entries in the rfmaster(4) 
file are syntactically validated. 

This command is restricted to the super-user. 

ERRORS 

If syntax errors are found in validating the rfmaster(4) file, a warning 
describing each error will be sent to standard error. 

If (1) the shared resource environment is already running, (2) there is no 
communications network, (3) the domain name server cannot be found, (4) 
the domain name server does not recognize the machine, or (5) the com- 
mand is run without super-user privileges, an error message will be sent to 
standard error. 

Remote file sharing will not start if the host password in 
/usr/nserve/loc.passwd is corrupted. If you suspect this has happened, 
remove the file and run rfstart again to reenter your password. 
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NOTE: rfstart will not fail if your host password does not match the pass- 
word on the domain name server. You will simply receive a warning mes- 
sage. However, if you try to mount a resource from the primary or any 
other host that validates your password, the mount will fail if your pass- 
word does not match the one that host has listed for your machine. 

FILES 

/usr /nserve /rf master 
/usr/nserve /loc.passwd 

SEE ALSO 

adv(lM), dname(lM), mount(lM), rfadmin(lM), rfstop(lM), unadv(lM). 
rfmaster(4) in the Programmer's Reference Manual. 
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NAME 

rfstop - stop the Remote File Sharing environment 

SYNOPSIS 

rfstop 

DESCRIPTION 

rfstop disconnects a host from the Remote File Sharing environment until 
another rfstart(lM) is executed. 

When executed on the domain name server, the domain name server 
responsibility is moved to a secondary name server as designated in the 
rfmaster file. 

This command is restricted to the super-user. 
ERRORS 

If (1) there are resources currently advertised by this host, (2) resources from 
this machine are still remotely mounted by other hosts, (3) there are still 
remotely mounted resources in the local file system tree, (4) rfstart{lM) had 
not previously been executed, or (5) the command is not run v^ith super- 
user privileges, an error message will be sent to standard error. 

SEE ALSO 

adv(lM), mount(lM), rfadmin(lM), rfstart(lM), unadv(lM). 
rfmaster(4) in the Programmer's Reference Manual. 
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NAME 

rfuadmin - Remote File Sharing notification shell script 
SYNOPSIS 

rfuadmin message remote—resource [seconds] 
DESCRIPTION 

The rfuadmin administrative shell script responds to unexpected Remote File 
Sharing events, such as broken network connections and forced unmounts, 
picked up by the rfudaemon process. This command is not intended to be 
run directly from the shell. 

The response to messages received by rfudaemon can be tailored to suit the 
particular system by editing the rfuadmin script. The following paragraphs 
describe the arguments passed to rfuadmin and the responses. 

disconnect remote— resource 

A link to a remote resource has been cut. rfudaemon executes 
rfuadmin, passing it the message disconnect and the name of the 
disconnected resource, rfuadmin sends this message to all terminals 
using zvall(l): 

Remote— resource has been disconnected from the system. 

Then it executes fuser(lM) to kill all processes using the resource, 
unmounts the resource [see umount(lM)] to clean up the kernel, 
and starts rmount to try to remount the resource. 

fumount remote—resource 

A remote server machine has forced an unmount of a resource a 
local machine has mounted. The processing is similar to process- 
ing for a disconnect. 

fuwarn remote— resource seconds 

This message notifies rfuadmin that a resource is about to be 
unmounted, rfudaemon sends this script the fuwarn message, the 
resource name, and the number of seconds in which the forced 
unmount will occur, rfuadmin sends this message to all terminals: 

Remote— resource is being removed from the system in # seconds. 

SEE ALSO 

fumount(lM), rmount(lM), rfstart(lM), rfudaemon(lM), wall(l). 

BUGS 

The console must be on when Remote File Sharing is running. If it's not, 
rfuadmin will hang when it tries to write to the console (wall) and recovery 
from disconnected resources will not complete. 
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NAME 

rfudaemon - Remote File Sharing daemon process 

SYNOPSIS 

rfudaemon 

DESCRIPTION 

The rfudaemon command is started automatically by rfstart{lM) and runs as 
a daemon process as long as Remote File Sharing is active. Its function is to 
listen for unexpected events, such as broken network connections and 
forced unmounts, and to execute appropriate administrative procedures. 

When such an event occurs, rfudaemon executes the administrative shell 
script rfuadmin, with arguments that identify the event. This command is 
not intended to be run from the shell. Here are the events: 

DISCONNECT 

A link to a remote resource has been cut. rfudaemon executes 
rfuadmin with two arguments: disconnect and the name of the 
disconnected resource. 

FUMOUNT 

A remote server machine has forced an unmount of a resource a 
local machine has mounted, rfudaemon executes rfuadmin with two 
arguments: fumount and the name of the disconnected resource. 

GETUMSG 

A remote user-level program has sent a message to the local rfu- 
daemon. Currently the only message sent is fuwarn, which notifies 
rfuadmin that a resource is about to be unmounted. It sends rfuad- 
min the fuwarn, the resource name, and the number of seconds in 
which the forced unmount will occur. 

LASTUMSG 

The local machine wants to stop the rfudaemon [see rfstop{\M)\, 
This causes rfudaemon to exit. 

SEE ALSO 

rfstart(lM), rfuadmin(lM). 
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NAME 

rm, rmdir - remove files or directories 

SYNOPSIS 

rm [-f] [-i] file ... 

rm -r [-f\ [-i] dirname ... [file ...] 

rmdir [-p] [-s] dirname ... 

DESCRIPTION 

rm removes the entries for one or more files from a directory. If an entry 
was the last link to the file, the file is destroyed. If a directory is writable 
and has the sticky bit set, files within that directory can be removed only if 
one or more of the following is true [see unlink(2)]: 

the user owns the file 
the user owns the directory 
the file is writable by the user 
the user is the super-user 

If a file has no write permission and the standard input is a terminal, the 
full set of permissions (in octal) for the file are printed followed by a ques- 
tion mark. This is a prompt for confirmation. If the answer begins with y 
(for yes), the file is deleted, otherwise the file remains. 

Note that if the standard input is not a terminal, the command will operate 
as if the -f option is in effect. 

The rmdir command removes the named directory if it is empty and the 
parent directory is writable. If the parent directory has the sticky bit set, 
removal occurs only if one of the following is true: 

the parent directory is owned by the user 
the dirname directory is owned by the user 
the dirname directory is writable to the user 
the user is the super-user 

Three options apply to rm: 

-f This option causes the removal of all files (whether write-protected or 
not) in a directory without prompting the user. In a write-protected 
directory, however, files are never removed (whatever their permis- 
sions are), but no messages are displayed. If the removal of a write- 
protected directory was attempted, this option cannot suppress an 
error message. 

-r This option causes the recursive removal of any directories and sub- 
directories in the argument list. The directory will be emptied of files 
and removed. Note that the user is normally prompted for removal of 
any write-protected files which the directory contains. The write- 
protected files are removed without prompting, however, if the -f 
option is used, or if the standard input is not a terminal and the -i 
option is not used. 

If the removal of a non-empty, write-protected directory was 
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attempted, the command will always fail (even if the -f option is 
used), resulting in an error message. 

-i With this option, confirmation of removal of any write-protected file 
occurs interactively. It overrides the -f option and remains in effect 
even if the standard input is not a terminal. 

Two options apply to rmdir: 

-p This option allows users to remove the directory dirname and its 
parent directories which become empty. A message is printed on stan- 
dard output as to whether the whole path is removed or part of the 
path remains for some reason. 

-s This option is used to suppress the message printed on standard error 
when -p is in effect. 

DIAGNOSTICS 

All messages are generally self-explanatory. 

It is forbidden to remove the files "." and in order to avoid the 

consequences of inadvertently doing something like the following: 

rm -r .* 

Both rm and rmdir return exit codes of if all the specified directories are 
removed successfully. Otherwise, they return a non-zero exit code. 

SEE ALSO 

chmod(l). 

rmdir(2), unlink(2) in the Programmer's Reference Manual. 
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NAME 

rmntstat - display mounted resource information 

SYNOPSIS 

rmntstat [-h] [resource] 

DESCRIPTION 

When used with no options, rmntstat displays a list of all local Remote File 
Sharing resources that are remotely mounted, the local path name, and the 
corresponding clients, rmntstat returns the remote mount data regardless of 
whether a resource is currently advertised; this ensures that resources that 
have been unadvertised but are still remotely mounted are included in the 
report. When a resource is specified, rmntstat displays the remote mount 
information only for that resource. The -h option causes header informa- 
tion to be omitted from the display. 

EXIT STATUS 

If no local resources are remotely mounted, rmntstat will return a successful 
exit status. 

ERRORS 

If resource (1) does not physically reside on the local machine or (2) is an 
invalid resource name, an error message will be sent to standard error. 

SEE ALSO 

mount(lM), fumount(lM), unadv(lM). 
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NAME 

rmount - retry remote resource mounts 

SYNOPSIS 

/etc/rmount -d[r] special directory 

DESCRIPTION 

The rmount command is an administrative shell script that tries to mount 
remote resource special on directory. If the remote mount is unsuccessful, 
rmount will wait 60 seconds and try to mount the resource again. This will 
repeat forever. The RETRIES=0 value in the shell script can be changed to 
limit the number of times the shell script will try to mount a remote 
resource. The wait time (TIME=60) can also be changed. 

See mount(lM) for a description of the options. 

FILES 

/etc/mnttab mount table 
SEE ALSO 

fumount(lM), fuser(lM), mount(lM), rfstart(lM), rfuadmin(lM), 
setmnt(lM). 

mnttab(4) in the Programmer's Reference Manual. 
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NAME 

rmountall, rumountall - mount, unmount Remote File Sharing resources 
SYNOPSIS 

/etc/rmountall [-] " file-system-table " [...] 
/etc/rumountall [ -k ] 

DESCRIPTION 

The rmountall command is a Remote File Sharing command used to mount 
remote resources according to a file-sy stem-table, (/etc/fstab is the recom- 
mended file-system-table.) The special file name "-" reads from the stan- 
dard input. 

The rumountall command causes all mounted remote resources to be 
unmounted. The -k option sends a SIGKILL signal, via fuser{lM), to 
processes that have files open. 

These commands may be executed only by the super-user. 
The file-system-table format is as follows: 

column 1 block special file name of file system 

column 2 mount-point directory 

column 3 -r if to be mounted read-only; -d if remote resource 

column 4 file system type (not use with Remote File Sharing) 

column 5+ ignored 

White space separates columns. Lines beginning with "#" are comments. 
Empty lines are ignored. 

SEE ALSO 

fuser(lM), mount(lM), rfstart(lM). 

signal(2) in the Programmer's Reference Manual 

DIAGNOSTICS 

No messages are printed if the remote resources are mounted successfully. 
Error and warning messages come from mount(lM). 

NOTES 

The information displayed in Column 3 will only appear if the file system 
was mounted as a read-only or remote resource. 
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NAME 

rumount - cancel queued remote resource request 

SYNOPSIS 

/usr/nserve/rumount resource . . . 

DESCRIPTION 

rumount cancels a request for one or more resources that are queued for 
mount. Entries for the resources are deleted from /usr/nserve/rmnttab. 

FILES 

/usr/nserve/rmnttab pending mount requests 
SEE ALSO 

mount(lM), rmnttry(lM), rmount(lM), rmountall(lM). 
mnttab(4) in the Programmer's Reference Manual. 
DIAGNOSTICS 

An exit code of is returned if rumount completes successfully. A 1 is 
returned if the resource requested for dequeuing is not in 
/usr/nserve/rmnttab, and a 2 is returned for bad usage or an error in read- 
ing or writing /usr/nserve/rmnttab. 
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NAME 

runacct - run daily accounting 

SYNOPSIS 

/usr/lib/acct/runacct [mmdd [state]] 

DESCRIPTION 

runacct is the main daily accounting shell procedure. It is normally initiated 
via cron(lM). runacct processes connect, fee, disk, and process accounting 
files. It also prepares summary files for prdaily or billing purposes, runacct 
is distributed only to source code licensees. 

runacct takes care not to damage active accounting files or summary files in 
the event of errors. It records its progress by writing descriptive diagnostic 
messages into active. When an error is detected, a message is v^ritten to 
/dev/console, mail [see mail(l)] is sent to root and adm, and runacct ter- 
minates, runacct uses a series of lock files to protect against re-invocation. 
The files lock and lockl are used to prevent simultaneous invocation, and 
lastdate is used to prevent more than one invocation per day. 

runacct breaks its processing into separate, restartable states using statefile 
to remember the last state completed. It accomplishes this by writing the 
state name into statefile. runacct then looks in statefile to see what it has 
done and to determine what to process next. States are executed in the fol- 
lowing order: 



PROCESS 



SETUP 



WTMPFIX 



DISK 



FEES 



CONNECT2 



MERGE 



CONNECTl 



Move active accounting files into working files. 

Verify integrity of wtmp file, correcting date changes 
if necessary. 

Produce connect session records in ctmp.h format. 

Convert ctmp.h records into tacct.h format. 

Convert process accounting records into tacct.h for- 
mat. 

Merge the connect and process accounting records. 

Convert output of chargefee into tacct.h format and 
merge with connect and process accounting records. 

Merge disk accounting records with connect, process, 
and fee accounting records. 



MERGETACCT 



CMS 



Merge the daily total accounting records in daytacct 
with the summary total accounting records in 
/usr/adm /acct /sum /tacct . 

Produce command summaries. 



USEREXIT 



Any installation-dependent accounting programs can 
be included here. 



CLEANUP 



Cleanup temporary files and exit. 
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To restart runacct after a failure, first check the active file for diagnostics, 
then fix up any corrupted data files such as pacct or wtmp. The lock files 
and lastdate file must be removed before runacct can be restarted. The 
argument mmdd is necessary if runacct is being restarted, and specifies the 
month and day for which runacct will rerun the accounting. Entry point for 
processing is based on the contents of statefile; to override this, include the 
desired state on the command line to designate where processing should 
begin. 

EXAMPLES 

To start runacct. 

nohup runacct 2> /usr/adm/acct/nite/fd21og & 

To restart runacct. 

nohup runacct 0601 2» /usr/adm/acct/nite/fd21og & 

To restart runacct at a specific state. 

nohup runacct 0601 MERGE 2» /usr/adm/acct/nite/fd21og & 

FILES 

/etc/ wtmp 
/usr /adm /pacct* 
/usr/src /cmd /acct/ tacct.h 
/usr /src /cmd /acct /ctmp.h 
/usr/adm /acct /nite /active 
/usr /adm /acct /nite /day tacct 
/usr/adm /acct /nite /lock 
/usr /adm /acct /nite /lockl 
/usr /adm /acct /nite /lastdate 
/usr /adm/acct /nite /statefile 
/usr/adm/acct/nite/ptacct*. mm^^rf 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), 

acctsh(lM), cron(lM), fwtmp(lM), mail(l). 

acct(2), acct(4), utmp(4) in the Programmer's Reference Manual. 

BUGS 

Normally, it is not a good idea to restart runacct in the SETUP state. Run 
SETUP manually and restart via: 

runacct mmdd WTMPFIX 

If runacct failed in the PROCESS state, remove the last ptacct file because it 
will not be complete. 
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NAME 

sag - system activity graph 

SYNOPSIS 

sag [ options ] 

DESCRIPTION 

The sag command graphically displays the system activity data stored in a 
binary data file by a previous sflr(l) run. Any of the sar data items may be 
plotted singly, or in combination; as cross plots, or versus time. Simple 
arithmetic combinations of data may be specified. The sag command 
invokes sar and finds the desired data by string-matching the data column 
header (run sar to see v^hat is available). These options are passed through 
to sar: 

-s time Select data later than time in the form hh[:mm]. Default is 08:00. 

-e time Select data up to time. Default is 18:00. 

-i sec Select data at intervals as close as possible to sec seconds. 

-{file Use file as the data source for sar. Default is the current daily 
data file /usr/adm/sa/sa^^^/. 

Other options: 

-T term Produce output suitable for terminal term. See tplot{lG) for 
known terminals. Default for term is $TERM. 

-X spec X axis specification with spec in the form: 

" name [op name] . . . [lo hi] " 

-y spec y axis specification with spec in the same form as above. 

Name is either a string that will match a column header in the sar report, 
with an optional device name in square brackets, e.g., r+w/s[dsk-l], or an 
integer value. Op is + - * or / surrounded by blanks. Up to five names 
may be specified. Parentheses are not recognized. Contrary to custom, 
+ and - have precedence over * and /. Evaluation is left to right. 
Thus A / A + B * 100 is evaluated (A/(A-fB))*100, and 
A + B/ C + Dis (A+B)/(C+D). Lo and hi are optional numeric scale 
limits. If unspecified, they are deduced from the data. 

A single spec is permitted for the x axis. If unspecified, time is used. Up to 
5 s;;ec's separated by ; may be given for -y. Enclose the -x and -y argu- 
ments in " " if blanks or \<CR> are included. The -y default is: 

-y "%usr 100; %usr + %sys 100; %usr + %sys + %wio 100" 

EXAMPLES 

To see today's CPU utilization: 

sag 

To see activity over 15 minutes of all disk drives: 

TS=date +%H:%M 
sar -o tempfile 60 15 
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TE=date +%H:%M 

sag -f tempfile -s $TS -e $TE -y "r+w/s[dsk] 

FILES 

/usr/adm/sa/safi(i daily data file for day dd, 

SEE ALSO 

sar(l), tplot(lG) 
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NAME 

sar - system activity reporter 
SYNOPSIS 

sar [ -ubdycwaqvmprDS AC ] [-o file] t [ n ] 

sar [ -ubdycwaqvmprDS AC ] [-s time] [-e time] [-i sec] [-f file] 
DESCRIPTION 

sar, in the first instance, samples cumulative activity counters in the operat- 
ing system at n intervals of t seconds, where t should be 5 or greater. If the 
-o option is specified, it saves the samples in file in binary format. The 
default value of n is 1. In the second instance, with no sampling interval 
specified, sar extracts data from a previously recorded file, either the one 
specified by the -f option or, by default, the standard system activity daily 
data file /usr/sLdm/ssL/sadd for the current day dd. The starting and end- 
ing times of the report can be bounded via the -s and -e time arguments of 
the form hh[:mm[:ss]]. The -i option selects records at sec second intervals. 
Otherwise, all intervals found in the data file are reported. 

In either case, subsets of data to be printed are specified by option: 

-u Report CPU utilization (the default): 

%usr, %sys, %wio, %idle - portion of time running in user mode, 
running in system mode, idle with some process waiting for block I/O, 
and otherwise idle. When used with -D, %sys is split into percent of 
time servicing requests from remote machines (%sys remote) and all 
other system time (%sys local). 

-b Report buffer activity: 

bread/s, bwrit/s - transfers per second of data between system buffers 

and disk or other block devices; 

Iread/s, Iwrit/s - accesses of system buffers; 

%rcache, %wcache - cache hit ratios, i. e., (1-bread/lread) as a per- 
centage; 

pread/s, pwrit/s - transfers via raw (physical) device mechanism. 
When used with -D, buffer caching is reported for locally-mounted 
remote resources. 

-d Report activity for each block device, e. g., disk or tape drive. When 
data is displayed, the device specification dsk- is generally used to 
represent a disk drive. The device specification used to represent a 
tape drive is machine dependent. The activity data reported is: 
%busy, avque - portion of time device was busy servicing a transfer 
request, average number of requests outstanding during that time; 
r+w/s, blks/s - number of data transfers from or to device, number of 
bytes transferred in 512-byte units; 

a V wait, avserv - average time in ms. that transfer requests wait idly 
on queue, and average time to be serviced (which for disks includes 
seek, rotational latency, and data transfer times). 

-y Report TTY device activity: 

rawch/s, canch/s, outch/s - input character rate, input character rate 
processed by canon, output character rate; 
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rcvin/s, xmtin/s, mdmin/s - receive, transmit and modem interrupt 
rates. 

-c Report system calls: 

scall/s - system calls of all types; 

sread/s, swrit/s, fork/s, exec/s - specific system calls; 

rchar/s, wchar/s - characters transferred by read and write system 

calls. When used with -D, the system calls are split into incoming, 

outgoing, and strictly local calls. 

-w Report system swapping and switching activity: 

swpin/s, swpot/s, bswin/s, bswot/s - number of transfers and 
number of 512-byte units transferred for swapins and swapouts 
(including initial loading of some programs); 
pswch/s - process switches. 

-a Report use of file access system routines: 
iget/s, namei/s, dirblk/s. 

-q Report average queue length while occupied, and % of time occupied: 
runq-sz, %runocc - run queue of processes in memory and runnable; 
swpq-sz, %swpocc - swap queue of processes swapped out but ready 
to run. 

-V Report status of process, inode, file tables: 

text-sz, proc-sz, inod-sz, file-sz, lock-sz - entries/size for each table, 
evaluated once at sampling point; 

ov - overflows that occur between sampling points for each table. 

-m Report message and semaphore activities: 
msg/s, sema/s - primitives per second. 

-p Report paging activities: 

vflt/s - address translation page faults (valid page not in memory); 
pflt/s - page faults from protection errors (illegal access to page) or 
" copy-on -writes " ; 

pgfil/s - vflt/s satisfied by page-in from file system; 
rclm/s - valid pages reclaimed for free list. 

-r Report unused memory pages and disk blocks: 

freemem - average pages available to user processes; 
freeswap - disk blocks available for process swapping. 

-D Report Remote File Sharing activity: 

When used in combination with -u, -b, or -c, it causes sar to produce 
the remote file sharing version of the corresponding report. -Du is 
assumed when only -D is specified. 

-S Report server and request queue status: 

Average number of Remote File Sharing servers on the system 
(serv/lo-hi), % of time receive descriptors are on the request queue 
(request %busy), average number of receive descriptors waiting for 
service when queue is occupied (request avg Igth), % of time there are 
idle servers (server %avail), average number of idle servers when idle 
ones exist (server avg avail). 
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-A Report all data. Equivalent to -udqbwcayvmprSDC. 

-C Report Remote File Sharing buffer caching overhead: 

snd-inv/s - number of invalidation messages per second sent by your 
machine as a server. 

snd-msg/s - total outgoing RFS messages sent per second. 

rcv-inv /s - number of invalidation messages received from the remote 

server. 

rcv-msg/s - total number of incoming RFS messages received per 
second. 

dis-bread/s - number of buffer reads that would be eligible for caching 
if caching were not turned off. (Indicates the penalty of running 
uncached.) 

blk-inv /s - number of buffers removed from the client cache. 

EXAMPLES 

To see today's CPU activity so far: 



To watch CPU activity evolve for 10 minutes and save data: 
sar -o temp 60 10 

To later review disk and tape activity from that period: 
sar -d -f temp 



FILES 



/usr/adm/sa/sa(id daily data file, where dd are digits representing the 
day of the month. 



SEE ALSO 

sag(lG), sar(lM). 
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NAME 

sar: sal, sa2, sadc - system activity report package 

SYNOPSIS 

/usr/lib/sa/sadc [t n] [ofile] 

/usr/lib/sa/sal [t n] 

/usr/lib/sa/sa2 [-ubdycwaqvmprDSAC] [-s time] [-e time] [-i sec] 
DESCRIPTION 

System activity data can be accessed at the special request of a user [see 
sflr(l)] and automatically on a routine basis as described here. The 
operating system contains several counters that are incremented as various 
system actions occur. These include counters for CPU utilization, buffer 
usage, disk and tape I/O activity, TTY device activity, switching and 
system-call activity, file-access, queue activity, inter-process 
communications, paging, and Remote File Sharing. 

sadc and shell procedures, sal and sa2, are used to sample, save, and 
process this data. 

sadc, the data collector, samples system data n times, with an interval of t 
seconds between samples, and writes in binary format to ofile or to standard 
output. The sampling interval t should be greater than 5 seconds; 
otherwise, the activity of sadc itself may affect the sample. If t and n are 
omitted, a special record is written. This facility is used at system boot 
time, when booting to a multiuser state, to mark the time at which the 
counters restart from zero. For example, the /etc/init.d/perf file writes the 
restart mark to the daily data by the command entry: 

su sys -c "/usr/lib/sa/sadc /usr/adm/sa/sa^date +%d\" 

The shell script sal, a variant of sadc, is used to collect and store data in 
binary file /usr/adm/sa/sarfrf where dd is the current day. The arguments 
t and n cause records to be written n times at an interval of t seconds, or 
once if omitted. The entries in /usr/spool/cron/crontabs/sys [see 
cron(lM)]: 

0***0-6 /usr/lib/sa/sal 

20,40 8-17 * * 1-5 /usr/lib/sa/sal 

will produce records every 20 minutes during working hours and hourly 
otherwise. 

The shell script sal, a variant of sar(l), writes a daily report in file 
/usr/adm/sa/sarrfrf. The options are explained in sar(l). The 
/usr /spool /cron /crontabs /sys entry: 

5 18 * * 1-5 /usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 1200 -A 
will report important activities hourly during the working day. 
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FILES 



The structure of the binary daily data file is: 

struct sa { 

struct sysinfo si; 
struct minfo mi; 
struct dinfo di; 
struct rcinfo rc; 



/* see /usr/include/sys/sysinfo.h */ 
/* defined in sys/sysinfo.h */ 
/* RFS info defined in sys/sysinfo.h */ 
/* Client cache info defined in sys/sysinfo.h */ 
struct bpbinfo bi; /* Co-processor info defined in sys/sysinfo.h */ 
int bpb_utilize /* Co-processor utilize flag */ 

int minserve, maxserve; /* RFS server low and high water marks */ 

int szinode; /* current size of inode table */ 

int szfile; /* current size of file table */ 

int szproc; /* current size of proc table */ 

int szlckf; /* current size of file record header table */ 

int szlckr; /* current size of file record lock table */ 

int mszinode; /* size of inode table */ 

int mszfile; /* size of file table */ 

int mszproc; /* size of proc table */ 

int mszlckf; /* maximum size of file record header table */ 
int mszlckr; /* maximum size of file record lock table */ 
long inodeovf; /* cumulative overflows of inode table */ 
long fileovf; /* cumulative overflows of file table */ 
long procovf; /* cumulative overflows of proc table */ 
time_t ts; /* time stamp, seconds */ 



long devio[NDEVS][4]; 
#define IO_OPS 
#define IO_BCNT 1 
#define IO_ACT 2 
#define IO_RESP 3 

}; 



/* device unit information */ 

/* cumulative I/O requests */ 

/* cumulative blocks transferred */ 

/* cumulative drive busy time in ticks */ 

/* cumulative I/O resp time in ticks */ 



/usr/adm/sa/sadrf daily data file 
/usr/adm /sa / sar dd daily report file 
/tmp/sa.adrfl addressfile 

SEE ALSO 

cron(lM), sag(lG), sar(l), timex(l). 
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NAME 



sdiff - side-by-side difference program 



SYNOPSIS 

sdiff [ options 



] filel file2 



DESCRIPTION 

The sdiff command uses the output of diff(l) to produce a side-by-side list- 
ing of two files indicating those lines that are different. Each line of the two 
files is printed with a blank gutter between them if the lines are identical, a 
< in the gutter if the line only exists in filel, a > in the gutter if the line 
only exists in filel, and a I for lines that are different. 



For example: 



X 

a 
b 
c 
d 



< 
< 



d 
c 



-1 



-s 



The following options exist: 

-w n Use the next argument, as the width of the output line. The 

default line length is 130 characters. 

Only print the left side of any lines that are identical. 

Do not print identical lines. 

o output Use the next argument, output, as the name of a third file that 
is created as a user-controlled merging of filel and filel. Identi- 
cal lines of filel and filel are copied to output. Sets of differ- 
ences, as produced by diff(l), are printed, where a set of differ- 
ences share a common gutter character. After printing each set 
of differences, sdiff prompts the user with a Vo and waits for one 
of the following user-typed commands: 

1 append the left column to the output file 

r append the right column to the output file 

s turn on silent mode; do not print identical lines 

V turn off silent mode 

e 1 call the editor with the left column 

e r call the editor with the right column 

e b call the editor with the concatenation of left and right 

e call the editor with a zero length file 

q exit from the program 

On exit from the editor, the resulting file is concatenated on the 
end of the output file. 



SEE ALSO 

diff(l), ed(l). 
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NAME 

sed - stream editor 

SYNOPSIS 

sed [-n] [-e script] [-f sfile] [files] 

DESCRIPTION 

sed copies the named files (standard input default) to the standard output, 
edited according to a script of commands. The -f option causes the script to 
be taken from file sfile; these options accumulate. If there is just one -e 
option and no -f options, the flag -e may be omitted. The -n option 
suppresses the default output. A script consists of editing commands, one 
per line, of the following form: 

[ address [ , address ] ] function [ arguments ] 

In normal operation, sed cyclically copies a line of input into a pattern space 
(unless there is something left after a D command), applies in sequence all 
commands whose addresses select that pattern space, and at the end of the 
script copies the pattern space to the standard output (except under -n) and 
deletes the pattern space. 

Some of the commands use a hold space to save all or part of the pattern 
space for subsequent retrieval. 

An address is either a decimal number that counts input lines cumulatively 
across files, a $ that addresses the last line of input, or a context address, 
i.e., a /regular expression/ in the style of ed(l) modified thus: 

In a context address, the construction \?regular expression? (where ? 
is any character) is identical to /regular expression/. Note 
that in the context address \xabc\xdefx, the second x 
stands for itself, so that the regular expression is abcxdef . 

The escape sequence \n matches a new-line embedded in the pattern 
space. 

A period . matches any character except the terminal new-line of the 
pattern space. 

A command line with no addresses selects every pattern space. 

A command line with one address selects each pattern space that 
matches the address. 

A command line with two addresses selects the inclusive range from 
the first pattern space that matches the first address through 
the next pattern space that matches the second. (If the 
second address is a number less than or equal to the line 
number first selected, only one line is selected.) Thereafter 
the process is repeated, looking again for the first address. 

Editing commands can be applied only to non-selected pattern spaces by 
use of the negation function ! (below). 

In the following list of functions, the maximum number of permissible 
addresses for each function is indicated in parentheses. 
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The text argument consists of one or more lines, all but the last of which 
end with \ to hide the new- line. Backslashes in text are treated like 
backslashes in the replacement string of an s command, and may be used to 
protect initial blanks and tabs against the stripping that is done on every 
script line. The rfile or wfile argument must terminate the command line 
and must be preceded by exactly one blank. Each wfile is created before 
processing begins. There can be at most 10 distinct wfile arguments. 

(1) a\ 

text Append. Place text on the output before reading the next input 

line. 

(2) b label Branch to the : command bearing the label. If label is empty, 

branch to the end of the script. 

(2)c\ 

text Change. Delete the pattern space. With or 1 address or at the 

end of a 2-address range, place text on the output. Start the next 
cycle. 

(2) d Delete the pattern space. Start the next cycle. 

(2)D Delete the initial segment of the pattern space through the first 

new-line. Start the next cycle. 
(2)g Replace the contents of the pattern space by the contents of the 

hold space. 

(2) G Append the contents of the hold space to the pattern space. 
(2)h Replace the contents of the hold space by the contents of the 
pattern space. 

(2) H Append the contents of the pattern space to the hold space. 

(1) i\ 

text Insert. Place text on the standard output. 

(2) 1 List the pattern space on the standard output in an unambiguous 

form. Non-printable characters are displayed in octal notation 
and long lines are folded. 

(2)n Copy the pattern space to the standard output. Replace the pat- 
tern space with the next line of input. 

(2)N Append the next line of input to the pattern space with an 
embedded new-line. (The current line number changes.) 

(2) p Print. Copy the pattern space to the standard output. 

(2)P Copy the initial segment of the pattern space through the first 
new-line to the standard output. 

(1) q Quit. Branch to the end of the script. Do not start a new cycle. 

(l)r rfile Read the contents of rfile. Place them on the output before read- 
ing the next input line. 

{l)s/ regular expression /replacement /flags 

Substitute the replacement string for instances of the regular 
expression in the pattern space. Any character may be used 
instead of /. For a fuller description see ed{\). Flags is zero or 
more of: 

n n = l- 512. Substitute for just the n-th occurrence 

of the regular expression. 
g Global. Substitute for all nonoverlapping instances of 

the regular expression rather than just the first one. 
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p Print the pattern space if a replacement was made, 

w wfile Write. Append the pattern space to zvfile if a replace- 
ment was made. 

(2) t label Test. Branch to the : command bearing the label if any substitu- 
tions have been made since the most recent reading of an input 
line or execution of a t. If label is empty, branch to the end of 
the script. 

(2) w wfile 

Write. Append the pattern space to wfile. 
(2)x Exchange the contents of the pattern and hold spaces. 

(2) y/stringl /string!/ 

Transform. Replace all occurrences of characters in stringl with 

the corresponding character in stringl. The lengths of stringl 

and stringl must be equal. 
(2)! function 

Don't. Apply the function (or group, if function is { ) only to 
lines not selected by the address(es). 

(0) : label This command does nothing; it bears a label for b and t com- 

mands to branch to. 

(1) = Place the current line number on the standard output as a line. 

(2) { Execute the following commands through a matching } only 

when the pattern space is selected. 
(0) An empty command is ignored. 

(0)# If a # appears as the first character on the first line of a script 
file, then that entire line is treated as a comment, with one 
exception. If the character after the # is an 'n', then the default 
output will be suppressed. The rest of the line after #n is also 
ignored. A script file must contain at least one non-comment 
line. 

SEE ALSO 

awk(l), ed(l), grep(l). 
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NAME 

setmnt - establish mount table 

SYNOPSIS 

/etc/setmnt 

DESCRIPTION 

The setmnt command creates the /etc/mnttab table, which is needed for 
both the mount{lM) and umount commands. The setmnt command reads 
standard input and creates a mnttah entry for each line. Input lines have 
the format: 

filesys node 

where filesys is the name of the file system's special file (e.g., 
/dev/dsk/lsl) and node is the root name of that file system. Thus filesys 
and node become the first two strings in the mount table entry. 

FILES 

/etc/mnttab 

SEE ALSO 

mount(lM). 

BUGS 

Problems may occur if filesys or node are longer than 32 characters. 

The setmnt command silently enforces an upper limit on the maximum 

number of mnttah entries. 
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NAME 

settime - change a files access and modification dates 
SYNOPSIS 

settime mmddhhmm [ yy ] [ -f fname ] name ... 
DESCRIPTION 

settime sets the access and modification dates for one or more files. The 
dates are set to the specified date or to the access and modification dates of 
the file specified via -f. Exactly one of these methods must be used to 
specify the new date(s). The first mm is the month number; dd is the day 
number in the month; hh is the hour number (24 hour system); the second 
mm is the minute number; yy is the last two digits of the year and is 
optional. For example: 

settime 1008004583 ralph pete 
sets the access and modification dates of files ralph and pete to Oct 8, 12:45 
AM, 1983. Another example: 

settime -f ralph john 
This sets the access and modification dates of the file john to those of the 
file ralph, 

SEE ALSO 

date(l), touch(l). 

NOTES 

Use of touch in place of settime is encouraged. 
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NAME 

sh, rsh - shell, the standard/restricted command programming language 

SYNOPSIS 

sh [ -acefhiknrstuvx ] [ args ] 
rsh [ -acefhiknrstuvx ] [ args ] 

DESCRIPTION 

sh is a command programming language that executes commands read from 
a terminal or a file, rsh is a restricted version of the standard command 
interpreter sh; it is used to set up login names and execution environments 
whose capabilities are more controlled than those of the standard shell. See 
Invocation below for the meaning of arguments to the shell. 

Definitions 

A blank is a tab or a space. A name is a sequence of letters, digits, or 
underscores beginning with a letter or underscore. A parameter is a name, a 
digit, or any of the characters *, @, #, ?, $, and !. 

Commands 

A simple-command is a sequence of non-blank words separated by blanks. 
The first word specifies the name of the command to be executed. Except 
as specified below, the remaining words are passed as arguments to the 
invoked command. The command name is passed as argument [see 
exec {2)]. The value of a simple-command is its exit status if it terminates nor- 
mally, or (octal) 200-\-status if it terminates abnormally [see signal (2) for a 
list of status values]. 

A pipeline is a sequence of one or more commands separated by |. The 
standard output of each command but the last is connected by a pipe (2) to 
the standard input of the next command. Each command is run as a 
separate process; the shell waits for the last command to terminate. The 
exit status of a pipeline is the exit status of the last command. 

A list is a sequence of one or more pipelines separated by ;, &, &&, or | | , 
and optionally terminated by ; or &. Of these four symbols, ; and & have 
equal precedence, which is lower than that of && and | | . The symbols && 
and I I also have equal precedence. A semicolon (;) causes sequential exe- 
cution of the preceding pipeline; an ampersand (&) causes asynchronous 
execution of the preceding pipeline (i.e., the shell does not wait for that 
pipeline to finish). The symbol && ( | | ) causes the list following it to be 
executed only if the preceding pipeline returns a zero (non-zero) exit status. 
An arbitrary number of new-lines may appear in a list, instead of semi- 
colons, to delimit commands. 

A command is either a simple-command or one of the following. Unless oth- 
erwise stated, the value returned by a command is that of the last simple- 
command executed in the command. 

for name [ in word ... ] do list done 

Each time a for command is executed, name is set to the next word 
taken from the in word list. If in word ... is omitted, then the for 
command executes the do list once for each positional parameter 
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that is set (see Parameter Substitution below). Execution ends when 
there are no more words in the list. 

case word in [ pattern [ \ pattern ] . . . ) list ;; ] . . . esac 

A case command executes the list associated with the first pattern 
that matches word. The form of the patterns is the same as that 
used for file-name generation (see File Name Generation) except that 
a slash, a leading dot, or a dot immediately following a slash need 
not be matched explicitly. 

if list then list [ elif list then list ] . . . [ else list ] fi 

The list following if is executed and, if it returns a zero exit status, 
the list following the first then is executed. Otherwise, the list fol- 
lowing elif is executed and, if its value is zero, the list following the 
next then is executed. Failing that, the else list is executed. If no 
else list or then list is executed, then the if command returns a zero 
exit status. 

while list do list done 

A while command repeatedly executes the while list and, if the 
exit status of the last command in the list is zero, executes the do 
list; otherwise the loop terminates. If no commands in the do list 
are executed, then the while command returns a zero exit status; 
until may be used in place of while to negate the loop termination 
test. 

(list) 

Execute list in a sub-shell. 

{list;} 

list is executed in the current (that is, parent) shell. 
name () {list;} 

Define a function which is referenced by name. The body of the 
function is the list of commands between { and }. Execution of 
functions is described below (see Execution below). 

The following words are only recognized as the first word of a command 
and when not quoted: 

if then else elif fi case esac for while until do done { } 

Comments 

A word beginning with # causes that word and all the following characters 
up to a new-line to be ignored. 

Command Substitution 

The shell reads commands from the string between two grave accents ('') 
and the standard output from these commands may be used as all or part of 
a word. Trailing new-lines from the standard output are removed. 

No interpretation is done on the string before the string is read, except to 
remove backslashes (\) used to escape other characters. Backslashes may be 
used to escape a grave accent (') or another backslash (\) and are removed 
before the command string is read. Escaping grave accents allows nested 
command substitution. If the command substitution lies within a pair of 
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double quotes (" ..." ..." ... "), a backslash used to escape a double quote 
(\ " ) will be removed; otherwise, it will be left intact. 

If a backslash is used to escape a new-line character (\new-line), both the 
backslash and the new-line are removed (see the later section on Quoting). 
In addition, backslashes used to escape dollar signs (\$) are removed. Since 
no interpretation is done on the command string before it is read, inserting a 
backslash to escape a dollar sign has no effect. Backslashes that precede 
characters other than \, \ ", new-line, and $ are left intact when the com- 
mand string is read. 

Parameter Substitution 

The character $ is used to introduce substitutable parameters . There are two 
types of parameters, positional and keyword. If parameter is a digit, it is a 
positional parameter. Positional parameters may be assigned values by set. 
Keyword parameters (also known as variables) may be assigned values by 
writing: 

name = value [ name = value ] . . . 

Pattern-matching is not performed on value. There cannot be a function 
and a variable with the same name . 

$ {parameter} 

The value, if any, of the parameter is substituted. The braces are 
required only when parameter is followed by a letter, digit, or 
underscore that is not to be interpreted as part of its name. If 
parameter is * or @, all the positional parameters, starting with $1, 
are substituted (separated by spaces). Parameter $0 is set from argu- 
ment zero when the shell is invoked. 

${parameter:-word } 

If parameter is set and is non-null, substitute its value; otherwise 
substitute word. 

${parameter:=word } 

If parameter is not set or is null, set it to word; the value of the 
parameter is substituted. Positional parameters may not be assigned 
in this way. 

${parameter:?word } 

If parameter is set and is non-null, substitute its value; otherwise, 
print word and exit from the shell. If word is omitted, the message 
"parameter null or not set'' is printed. 

${parameteri+word } 

If parameter is set and is non-null, substitute word; otherwise substi- 
tute nothing. 

In the above, word is not evaluated unless it is to be used as the substituted 
string, so that, in the following example, pwd is executed only if d is not set 
or is null: 

echo ${d:-'pwd*} 
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If the colon (:) is omitted from the above expressions, the shell only checks 
whether parameter is set or not. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal. 

Flags supplied to the shell on invocation or by the set com- 
mand. 

? The decimal value returned by the last synchronously exe- 

cuted command. 
$ The process number of this shell. 

! The process number of the last background command 

invoked. 

The following parameters are used by the shell: 

HOME The default argument (home directory) for the cd command. 
PATH The search path for commands (see Execution below). The 
user may not change PATH if executing under rsh . 

CDPATH 

The search path for the cd command. 
MAIL If this parameter is set to the name of a mail file and the 

MAILPATH parameter is not set, the shell informs the user 

of the arrival of mail in the specified file. 
MAILCHECK 

This parameter specifies how often (in seconds) the shell 
will check for the arrival of mail in the files specified by the 
MAILPATH or MAIL parameters. The default value is 600 
seconds (10 minutes). If set to 0, the shell will check before 
each prompt. 
MAILPATH 

A colon (:) separated list of file names. If this parameter is 
set, the shell informs the user of the arrival of mail in any 
of the specified files. Each file name can be followed by % 
and a message that will be printed when the modification 
time changes. The default message is you have mail . 

PSl Primary prompt string, by default "$ 

PS2 Secondary prompt string, by default "> 

IPS Internal field separators, normally space, tab, and new-line. 

SHACCT 

If this parameter is set to the name of a file writable by the 
user, the shell will write an accounting record in the file for 
each shell procedure executed. 
SHELL When the shell is invoked, it scans the environment (see 
Environment below) for this name. If it is found and 'rsh' is 
the file name part of its value, the shell becomes a restricted 
shell. 
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The shell gives default values to PATH, PSl, PS2, MAILCHECK, and IPS. 
HOME and MAIL are set by login(l). 

Blank Interpretation 

After parameter and command substitution, the results of substitution are 
scanned for internal field separator characters (those found in IPS) and split 
into distinct arguments where such characters are found. Explicit null argu- 
ments (" " or ") are retained. Implicit null arguments (those resulting from 
parameters that have no values) are removed. 

Input/Output 

A command's input and output may be redirected using a special notation 
interpreted by the shell. The following may appear anywhere in a simple- 
command or may precede or follow a command and are not passed on as 
arguments to the invoked command. Note that parameter and command 
substitution occurs before word or digit is used. 

<word Use file word as standard input (file descriptor 0). 

>word Use file word as standard output (file descriptor 1). If the 

file does not exist it is created; otherwise, it is truncated to 
zero length. 

»word Use file word as standard output. If the file exists, output is 

appended to it (by first seeking to the end-of-file); otherwise, 
the file is created. 

«[-]word After parameter and command substitution is done on word, 
the shell input is read up to the first line that literally 
matches the resulting word, or to an end-of-file. If, how- 
ever, - is appended to «: 

(1) leading tabs are stripped from word before the shell 
input is read (but after parameter and command substi- 
tution is done on word), 

(2) leading tabs are stripped from the shell input as it is 
read and before each line is compared with word, and 

(3) shell input is read up to the first line that literally 
matches the resulting word, or to an end-of-file. 

If any character of word is quoted (see Quoting below), no 
additional processing is done to the shell input. If no char- 
acters of word are quoted: 

(1) parameter and command substitution occurs, 

(2) (escaped) \new-line is ignored, and 

(3) \ must be used to quote the characters \, $, and \ 
The resulting document becomes the standard input. 

<<kdigit Use the file associated with file descriptor digit as standard 

input; similarly for the standard output using >&:digit. 

<&- The standard input is closed; similarly for the standard out- 

put using >&-. 
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If any of the above is preceded by a digit, the file descriptor which will be 
associated with the file is that specified by the digit (instead of the default 
or 1). 

For example: 

... 2>&1 

associates file descriptor 2 with the file currently associated with file 
descriptor 1. 

The order in which redirections are specified is significant. The shell evalu- 
ates redirections left-to-right. For example: 

... l>xxx 2>&1 

first associates file descriptor 1 with file xxx. It associates file descriptor 2 
with the file associated with file descriptor 1 (i.e., xxx). If the order of 
redirections were reversed, file descriptor 2 would be associated with the 
terminal (assuming file descriptor 1 had been) and file descriptor 1 would be 
associated with file xxx . 

Using the terminology introduced on the first page, under Commands, if a 
command is composed of several simple-commands, redirection will be 
evaluated for the entire command before it is evaluated for each simple- 
command. That is, the shell evaluates redirection for the entire list, then 
each pipeline within the list, then each command within each pipeline, then 
each list within each command. 

If a command is followed by &, the default standard input for the command 
is the empty file /dev/nuU. Otherwise, the environment for the execution 
of a command contains the file descriptors of the invoking shell as modified 
by input/output specifications. 

Redirection of output is not allowed in the restricted shell. 

File Name Generation 

Before a command is executed, each command word is scanned for the char- 
acters *, ?, and [ . If one of these characters appears, the word is regarded 
as a pattern. The word is replaced with alphabetically sorted file names that 
match the pattern. If no file name is found that matches the pattern, the 
word is left unchanged. The character . at the start of a file name or 
immediately following a /, as well as the character / itself, must be matched 
explicitly. 

* Matches any string, including the null string. 

? Matches any single character. 

[ . . . ] Matches any one of the enclosed characters. A pair of char- 
acters separated by - matches any character lexically 
between the pair, inclusive. If the first character following 
the opening is a ""!"", any character not enclosed is 
matched. 
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Quoting 

The following characters have a special meaning to the shell and cause ter- 
mination of a word unless quoted: 

; & ( ) I < > new-line space tab 

A character may be quoted (i.e., made to stand for itself) by preceding it 
with a backslash (\) or inserting it between a pair of quote marks (" or 
" " ). During processing, the shell may quote certain characters to prevent 
them from taking on a special meaning. Backslashes used to quote a single 
character are removed from the word before the command is executed. The 
pair \new-line is removed from a word before command and parameter 
substitution. 

All characters enclosed between a pair of single quote marks ("), except a 
single quote, are quoted by the shell. Backslash has no special meaning 
inside a pair of single quotes. A single quote may be quoted inside a pair of 
double quote marks (for example, " ' " ). 

Inside a pair of double quote marks (" "), parameter and command substitu- 
tion occurs and the shell quotes the results to avoid blank interpretation and 
file name generation. If $* is within a pair of double quotes, the positional 
parameters are substituted and quoted, separated by quoted spaces ("$1 $2 
..."); however, if $@ is within a pair of double quotes, the positional 
parameters are substituted and quoted, separated by unquoted spaces ("$1" 
"$2" ... ). \ quotes the characters \, \ ", and $. The pair \new-line is 
removed before parameter and command substitution. If a backslash pre- 
cedes characters other than \, \ $, and new-line, then the backslash itself 
is quoted by the shell. 

Prompting 

When used interactively, the shell prompts with the value of PSl before 
reading a command. If at any time a new-line is typed and further input is 
needed to complete a command, the secondary prompt (i.e., the value of 
PS2) is issued. 

Environment 

The environment [see environ{5)] is a list of name-value pairs that is passed 
to an executed program in the same way as a normal argument list. The 
shell interacts with the environment in several ways. On invocation, the 
shell scans the environment and creates a parameter for each name found, 
giving it the corresponding value. If the user modifies the value of any of 
these parameters or creates new parameters, none of these affects the 
environment unless the export command is used to bind the shell's parame- 
ter to the environment (see also set -a). A parameter may be removed from 
the environment with the unset command. The environment seen by any 
executed command is thus composed of any unmodified name-value pairs 
originally inherited by the shell, minus any pairs removed by unset, plus 
any modifications or additions, all of which must be noted in export com- 
mands. 

The environment for any simple-command may be augmented by prefixing it 
with one or more assignments to parameters. Thus: 
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TERM=450 cmd and 
(export TERM; TERM=450; cmd) 

are equivalent (as far as the execution of cmd is concerned). 

If the -k flag is set, all keyword arguments are placed in the environment, 

even if they occur after the command name. 

The following first prints a=b c and c: 

echo a=b c 
set -k 
echo a=b c 

Signals 

The INTERRUPT and QUIT signals for an invoked command are ignored if 
the command is followed by &; otherwise signals have the values inherited 
by the shell from its parent, with the exception of signal 11 (but see also the 
trap command below). 

Execution 

Each time a command is executed, the above substitutions are carried out. 
If the command name matches one of the Special Commands listed below, it 
is executed in the shell process. If the command name does not match a 
Special Command, but matches the name of a defined function, the function 
is executed in the shell process (note how this differs from the execution of 
shell procedures). The positional parameters $1, $2, . . . . are set to the argu- 
ments of the function. If the command name matches neither a Special 
Command nor the name of a defined function, a new process is created and 
an attempt is made to execute the command via exec (2). 
The shell parameter PATH defines the search path for the directory contain- 
ing the command. Alternative directory names are separated by a colon (:). 
The default path is :/bin:/usr/bin (specifying the current directory, /bin, 
and /usr/bin, in that order). Note that the current directory is specified by 
a null path name, which can appear immediately after the equal sign, 
between two colon delimiters anywhere in the path list, or at the end of the 
path list. If the command name contains a /, the search path is not used; 
such commands will not be executed by the restricted shell. Otherwise, 
each directory in the path is searched for an executable file. If the file has 
execute permission but is not an a.out file, it is assumed to be a file contain- 
ing shell commands. A sub-shell is spawned to read it. A parenthesized 
command is also executed in a sub-shell. 

The location in the search path where a command was found is remem- 
bered by the shell (to help avoid unnecessary execs later). If the command 
was found in a relative directory, its location must be re-determined when- 
ever the current directory changes. The shell forgets all remembered loca- 
tions whenever the PATH variable is changed or the hash -r command is 
executed (see below). 

Special Commands 

Input/output redirection is now permitted for these commands. File 
descriptor 1 is the default output location. 
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: No effect; the command does nothing. A zero exit code is returned. 

. file Read and execute commands from file and return. The search path 

specified by PATH is used to find the directory containing file. 
break [ n ] 

Exit from the enclosing for or while loop, if any. If n is specified, 
break n levels. 

continue [ n ] 

Resume the next iteration of the enclosing for or while loop. If n is 
specified, resume at the n-th enclosing loop, 
cd [ arg ] 

Change the current directory to arg. The shell parameter HOME is 
the default arg. The shell parameter CDPATH defines the search 
path for the directory containing arg. Alternative directory names 
are separated by a colon (:). The default path is <null> (specifying 
the current directory). Note that the current directory is specified by 
a null path name, which can appear immediately after the equal 
sign or between the colon delimiters anywhere else in the path list. 
If arg begins with a / the search path is not used. Otherwise, each 
directory in the path is searched for arg. The cd command may not 
be executed by rsh. 

echo [ -n ][ arg ... ] 

Echo arguments. See echo(l) for usage and description, 
eval [ arg ... ] 

The arguments are read as input to the shell and the resulting 
command(s) executed, 
exec [ arg ... ] 

The command specified by the arguments is executed in place of 
this shell without creating a new process. Input/output arguments 
may appear and, if no other arguments are given, cause the shell 
input/output to be modified, 
exit [ n ] 

Causes a shell to exit with the exit status specified by n. If n is 
omitted, the exit status is that of the last command executed (an 
end-of-file will also cause the shell to exit.) 
export [ name ... ] 

The given names are marked for automatic export to the environ- 
ment of subsequently-executed commands. If no arguments are 
given, variable names that have been marked for export during the 
current shell's execution are listed. (Variable names exported from a 
parent shell are listed only if they have been exported again during 
the current shell's execution.) Function names are not exported. 

getopts 

Use in shell scripts to support command syntax standards [see 
intro{l)]; it parses positional parameters and checks for legal 
options. See getopts (1) for usage and description, 
hash [ -r ] [ name ... ] 

For each name, the location in the search path of the command 
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specified by name is determined and remembered by the shell. The 
-r option causes the shell to forget all remembered locations. If no 
arguments are given, information about remembered commands is 
presented. Hits is the number of times a command has been 
invoked by the shell process. Cost is a measure of the work 
required to locate a command in the search path. If a command is 
found in a "relative" directory in the search path, after changing to 
that directory, the stored location of that command is recalculated. 
Commands for which this will be done are indicated by an asterisk 
(*) adjacent to the hits information. Cost will be incremented when 
the recalculation is done. 

newgrp [ arg ... ] 

Equivalent to exec newgrp arg .... See newgrp(lM) for usage and 
description. 

pwd Print the current working directory. See pwd(l) for usage and 

description, 
read [ name ... ] 

One line is read from the standard input and, using the internal 
field separator, IFS (normally space or tab), to delimit word boun- 
daries, the first word is assigned to the first name, the second word 
to the second name, etc., with leftover words assigned to the last 
name. Lines can be continued using \new-line. Characters other 
than new-line can be quoted by preceding them with a backslash. 
These backslashes are removed before words are assigned to names, 
and no interpretation is done on the character that follows the 
backslash. The return code is unless an end-of-file is encountered. 

readonly [ name ... ] 

The given names are marked readonly and the values of the these 
names may not be changed by subsequent assignment. If no argu- 
ments are given, a list of all readonly names is printed. 

return [ n ] 

Causes a function to exit with the return value specified by n. If n 
is omitted, the return status is that of the last command executed, 
set [ — aefhkntuvx [arg ... ] ] 

-a Mark variables which are modified or created for export, 
-e Exit immediately if a command exits with a non-zero exit 
status. 

-f Disable file name generation 

-h Locate and remember function commands as functions are 
defined (function commands are normally located when the 
function is executed). 

-k All keyword arguments are placed in the environment for a 
command, not just those that precede the command name. 

-n Read commands but do not execute them. 

-t Exit after reading and executing one command. 
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-u Treat unset variables as an error when substituting. 

-V Print shell input lines as they are read. 

-X Print commands and their arguments as they are executed. 

Do not change any of the flags; useful in setting $1 to -. 
Using + rather than - causes these flags to be turned off. These 
flags can also be used upon invocation of the shell. The current set 
of flags may be found in $-. The remaining arguments are posi- 
tional parameters and are assigned, in order, to $1, $2, If no 

arguments are given, the values of all names are printed. 

shift [ n ] 

The positional parameters from $n+l . . . are renamed $1 If n 

is not given, it is assumed to be 1 . 

test 

Evaluate conditional expressions. See test{l) for usage and descrip- 
tion. 

times 

Print the accumulated user and system times for processes run from 
the shell. 

trap [ flr^ ] [ n ] . . . 

The command arg is to be read and executed when the shell 
receives signal(s) n. (Note that arg is scanned once when the trap is 
set and once when the trap is taken.) Trap commands are executed 
in order of signal number. Any attempt to set a trap on a signal 
that was ignored on entry to the current shell is ineffective. An 
attempt to trap on signal 11 (memory fault) produces an error. If 
arg is absent, all trap(s) n are reset to their original values. If arg is 
the null string, this signal is ignored by the shell and by the com- 
mands it invokes. If n is 0, the command arg is executed on exit 
from the shell. The trap command with no arguments prints a list 
of commands associated with each signal number. 

type [ name ... ] 

For each name, indicate how it would be interpreted if used as a 
command name. 

ulimit [ n ] 

Impose a size limit of n blocks on files written by the shell and its 
child processes (files of any size may be read). If n is omitted, the 
current limit is printed. You may lower your own ulimit, but only a 
super-user [see sm (IM)] can raise a ulimit. 
umask [ nnn ] 

The user file-creation mask is set to nnn [see umask{l)]. If nnn is 
omitted, the current value of the mask is printed, 
unset [ name . . . ] 

For each name, remove the corresponding variable or function. 
The variables PATH, FSl, PS2, MAILCHECK, and IPS cannot be 
unset. 
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wait [ n ] 

Wait for your background process whose process id is n and report 
its termination status. If n is omitted, all your shell's currently 
active background processes are waited for and the return code will 
be zero. 

Invocation 

If the shell is invoked through exec {2) and the first character of argument 
zero is -, commands are initially read from /etc/profile and from 
$HOME/.profile, if such files exist. Thereafter, commands are read as 
described below, which is also the case when the shell is invoked as 
/bin/sh. The flags below are interpreted by the shell on invocation only. 
Note that unless the -c or -s flag is specified, the first argument is assumed 
to be the name of a file containing commands, and the remaining arguments 
are passed as positional parameters to that command file: 

-c string If the -c flag is present, commands are read from string, 

-s If the -s flag is present or if no arguments remain, commands are 

read from the standard input. Any remaining arguments specify 
the positional parameters. Shell output (except for Special Com- 
mands) is written to file descriptor 2. 

-i If the -i flag is present or if the shell input and output are 

attached to a terminal, this shell is interactive. In this case TER- 
MINATE is ignored (so that kill does not kill an interactive 
shell) and INTERRUPT is caught and ignored (so that wait is 
interruptible). In all cases, QUIT is ignored by the shell. 

-r If the -r flag is present, the shell is a restricted shell. 

The remaining flags and arguments are described under the set command 
above. 

rsh Only 

rsh is used to set up login names and execution environments whose capa- 
bilities are more controlled than those of the standard shell. The actions of 
rsh are identical to those of sh, except that the following are disallowed: 

changing directory [see crf(l)], 
setting the value of $PATH, 

specifying path or command names containing /, 
redirecting output (> and »). 

The restrictions above are enforced after .profile is interpreted. 

A restricted shell can be invoked in one of the following ways: (1) rsh is 
the file name part of the last entry in the /etc/passwd file [see passwd{A)]) 
(2) the environment variable SHELL exists and rsh is the file name part of its 
value; (3) the shell is invoked and rsh is the file name part of argument 0; 
(4) the shell is invoked with the -r option. 

When a command to be executed is found to be a shell procedure, rsh 
invokes sh to execute it. Thus, it is possible to provide to the end-user shell 
procedures that have access to the full power of the standard shell, while 
imposing a limited menu of commands; this scheme assumes that the end- 
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user does not have write and execute permissions in the same directory. 

The net effect of these rules is that the writer of the .profile [see profile {4)] 
has complete control over user actions by performing guaranteed setup 
actions and leaving the user in an appropriate directory (probably not the 
login directory). 

The system administrator often sets up a directory of commands (i.e., 
/usr/rbin) that can be safely invoked by a restricted shell. Some systems 
also provide a restricted editor, red. 

EXIT STATUS 

Errors detected by the shell, such as syntax errors, cause the shell to return 
a non-zero exit status. If the shell is being used non-interactively, execution 
of the shell file is abandoned. Otherwise, the shell returns the exit status of 
the last command executed (see also the exit command above). 

FILES 

/etc/profile 
$HOME/.profile 
/tmp/sh* 
/dev/null 

SEE ALSO 

cd(l), echo(l), env(l), getopts(l), intro(l), login(l), newgrp(lM), pwd(l), 
test(l), umask(l), wait(l). 

dup(2), exec(2), fork(2), pipe(2), profile(4), signal(2), ulimit(2) in the 
Programmer's Reference Manual. 

CAVEATS 

Words used for file names in input/output redirection are not interpreted 
for file name generation (see File Name Generation above). For example, cat 
filel >a* will create a file named a*. 

Because commands in pipelines are run as separate processes, variables set 
in a pipeline have no effect on the parent shell. 

If you get the error message cannot fork, too many processes, try using the 
wait{l) command to clean up your background processes. If this doesn't 
help, the system process table is probably full or you have too many active 
foreground processes. (There is a limit to the number of process ids associ- 
ated with your login, and to the number the system can keep track of.) 

BUGS 

If a command is executed, and a command with the same name is installed 
in a directory in the search path before the directory where the original 
command was found, the shell will continue to exec the original command. 
Use the hash command to correct this situation. 

If you move the current directory or one above it, pwd may not give the 
correct response. Use the cd command with a full path name to correct this 
situation. 

Not all the processes of a 3- or more-stage pipeline are children of the shell, 
and thus cannot be waited for. 
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For wait n , if n is not an active process id, all your shell's currently active 
background processes are waited for and the return code will be zero. 
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NAME 

shl - shell layer manager 

SYNOPSIS 
shl 

DESCRIPTION 

The shl command allows a user to interact with more than one shell from a 
single terminal. The user controls these shells, known as layers, using the 
commands described below. 

The current layer is the layer which can receive input from the keyboard. 
Other layers attempting to read from the keyboard are blocked. Output 
from multiple layers is multiplexed onto the terminal. To have the output 
of a layer blocked when it is not current, the stty option loblk may be set 
within the layer. 

The stty character swtch (set to if NUL) is used to switch control to shl 
from a layer, shl has its own prompt, »>, to help distinguish it from a 
layer. 

A layer is a shell which has been bound to a virtual tty device 
(/dev/sxt???). The virtual device can be manipulated like a real tty device 
using stty(l) and ioctl{2). Each layer has its own process group id. 
Definitions 

A name is a sequence of characters delimited by a blank, tab, or new-line. 
Only the first eight characters are significant. The names (1) through (7) 
cannot be used when creating a layer. They are used by shl when no name 
is supplied. They may be abbreviated to just the digit. 

Commands 

The following commands may be issued from the shl prompt level. Any 
unique prefix is accepted. 

create [ name ] 

Create a layer called name and make it the current layer. If no 
argument is given, a layer will be created with a name of the form 
f#; where # is the last digit of the virtual device bound to the layer. 
The shell prompt variable PSl is set to the name of the layer fol- 
lowed by a space. A maximum of seven layers can be created. 

block name [ name ... ] 

For each name, block the output of the corresponding layer when it 
is not the current layer. This is equivalent to setting the stty option 
-loblk within the layer. 

delete name [ name ... ] 

For each name, delete the corresponding layer. All processes in the 
process group of the layer are sent the SIGHUP signal [see sig- 
nal(2)]. 

help (or ?) 

Print the syntax of the shl commands. 
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layers [ -1 ] [ name . . . ] 

For each name, list the layer name and its process group. The -1 
option produces a ;7s(l)-like listing. If no arguments are given, 
information is presented for all existing layers. 

resume [ name ] 

Make the layer referenced by name the current layer. If no argu- 
ment is given, the last existing current layer will be resumed. 

toggle Resume the layer that was current before the last current layer. 

unblock name [ name ... ] 

For each name, do not block the output of the corresponding layer 
when it is not the current layer. This is equivalent to setting the 
stty option -loblk within the layer. 

quit Exit shl . All layers are sent the SIGHUP signal. 

name Make the layer referenced by name the current layer. 



FILES 



/dev/sxt??? 
$SHELL 



Virtual tty devices 

Variable containing path name of the shell to use 
(default is /bin/sh). 



SEE ALSO 



sh(l), stty(l), sxt(7). 

ioctl(2), signal(2) in the Programmer's Reference Manual. 
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NAME 

shutdown - shut down system, change system state 
SYNOPSIS 

/etc/shutdown [ -y ] [ -ggrace_period [ -iinit_state ] 
DESCRIPTION 

This command is executed by the super-user to change the state of the 
machine. By default, it brings the system to a state where only the console 
has access to the UNIX system. This command can be executed from the 
console only. This state is traditionally called "single-user." 

The command sends a warning message and a final message before it starts 
actual shutdown activities. By default, the command asks for confirmation 
before it starts shutting down daemons and killing processes. The options 
are used as follows: 

-y pre-answers the confirmation question so the command can be run 
without user intervention. A default of 60 seconds is allowed 
between the warning message and the final message. Another 60 
seconds is allowed between the final message and the confirmation. 

-ggrace— period 

allows the super-user to change the number of seconds from the 
60-second default. 

-Unit— state 

specifies the state that init(lM) is to be put in following the warn- 
ings, if any. By default, system state "s" is used (the same as states 
"1" and "S"). 

Other recommended system state definitions are: 
state 

Shut the machine down so it is safe to remove the power. Have the 
machine remove power if it can. The /etc/rcO procedure is called to 
do this work. 

state 1, s, S 

Bring the machine to the state traditionally called single-user. The 
/etc/rcO procedure is called to do this work. (Though s and 1 are 
both used to go to single user state, s only kills processes spawned by 
init and does not unmount file systems. State 1 unmounts everything 
except root and kills all user processes, except those that relate to the 
console.) 

state 6 

Stop the UNIX system and reboot to the state defined by the initdefault 
entry in /etc/inittab. 

SEE ALSO 

init(lM), rcO(lM), rc2(lM). 

inittab(4) in the Programmer's Reference Manual. 
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NAME 

sleep - suspend execution for an interval 

SYNOPSIS 

sleep time 

DESCRIPTION 

The sleep command suspends execution for time seconds. It is used to exe- 
cute a command after a certain amount of time, as in: 

(sleep 105; command)&c 

or to execute a command every so often, as in: 

while true 
do 

command 
sleep 37 

done 

SEE ALSO 

alarm(2), sleep(3C) in the Programmer's Reference Manual, 
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NAME 

sort - sort and/or merge files 
SYNOPSIS 

sort [-emu] [-ooutput] [-ykmem] [-zrecsz] [-dfiMnr] [-btx] 
[+posl [-pos2]] [files] 

DESCRIPTION 

sort sorts lines of all the named files together and writes the result on the 
standard output. The standard input is read if - is used as a file name or no 
input files are named. 

Comparisons are based on one or more sort keys extracted from each line of 
input. By default, there is one sort key, the entire input line, and ordering 
is lexicographic by bytes in machine-collating sequence. 

The following options alter the default behavior: 

-c Check that the input file is sorted according to the ordering rules; give 
no output unless the file is out of sort. 

-m Merge only, the input files are already sorted. 

-u Unique: suppress all but one in each set of lines having equal keys. 

-ooutput 

The argument given is the name of an output file to use instead of the 
standard output. This file may be the same as one of the inputs. 
There may be optional blanks between -o and output. 

-ykmem 

The amount of main memory used by the sort has a large impact on 
its performance. Sorting a small file in a large amount of memory is a 
waste. If this option is omitted, sort begins using a system default 
memory size, and continues to use more space as needed. If this 
option is presented with a value, kmem, sort will start using that 
number of kilobytes of memory, unless the administrative minimum or 
maximum is violated, in which case the corresponding extremum will 
be used. Thus, -yO is guaranteed to start with minimum memory. By 
convention, -y (with no argument) starts with maximum memory. 

-zrecsz 

The size of the longest line read is recorded in the sort phase so 
buffers can be allocated during the merge phase. If the sort phase is 
omitted via the -c or -m options, a popular system default size will be 
used. Lines longer than the buffer size will cause sort to terminate 
abnormally. Supplying the actual number of bytes in the longest line 
to be merged (or some larger value) will prevent abnormal termina- 
tion. 

The following options override the default ordering rules. 

-d "Dictionary" order: only letters, digits, and blanks (spaces and tabs) 
are significant in comparisons. 

-f Fold lower-case letters into upper case. 
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-i Ignore non-printable characters. 

-M Compare as months. The first three non-blank characters of the field 
are folded to upper case and compared. For example, in English the 
sorting order is "JAN" < "FEB" < ... < "DEC". Invalid fields com- 
pare low to "JAN". The -M option implies the -b option (see the fol- 
lowing text). 

-n An initial numeric string, consisting of optional blanks, optional minus 
sign, and zero or more digits with optional decimal point, is sorted by 
arithmetic value. The -n option implies the -b option (see the follow- 
ing text). Note that the -b option is only effective when restricted sort 
key specifications are in effect. 

-r Reverse the sense of comparisons. 

When ordering options appear before restricted sort key specifications, the 
requested ordering rules are applied globally to all sort keys. When 
attached to a specific sort key (described in the following text), the specified 
ordering options override all global ordering options for that key. 

The notation +posl -pos2 restricts a sort key to one beginning at posl and 
ending just before posl. The characters at position posl and just before posl 
are included in the sort key (provided that posl does not precede posl). A 
missing -posl means the end of the line. 

Specifying posl and posl involves the notion of a field, a minimal sequence 
of characters followed by a field separator or a new-line. By default, the 
first blank (space or tab) of a sequence of blanks acts as the field separator. 
All blanks in a sequence of blanks are considered to be part of the next 
field; for example, all blanks at the beginning of a line are considered to be 
part of the first field. The treatment of field separators can be altered using 
the options: 

-b Ignore leading blanks when determining the starting and ending posi- 
tions of a restricted sort key. If the -b option is specified before the 
first +posl argument, it will be applied to all -\-posl arguments. Other- 
wise, the b flag may be attached independently to each +posl or -posl 
argument (see below). 

-ix Use X as the field separator character; x is not considered to be part of 
a field (although it may be included in a sort key). Each occurrence of 
X is significant (for example, xx delimits an empty field). 

Posl and posl each have the form m.n optionally followed by one or more 
of the flags bdfinr. A starting position specified by +in,n is interpreted to 
mean the n+lst character in the m+lst field. A missing ,n means .0, indi- 
cating the first character of the m4-lst field. If the b flag is in effect, n is 
counted from the first non-blank in the m-f-lst field; -l-m.Ob refers to the 
first non -blank character in the m+lst field. 

A last position specified by -m.n is interpreted to mean the nth character 
(including separators) after the last character of the mth field. A missing ,n 
means .0, indicating the last character of the mth field. If the b flag is in 
effect, n is counted from the last leading blank in the m + lst field; -m.lb 
refers to the first non-blank in the m+lst field. 
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When there are multiple sort keys, later keys are compared only after all 
earlier keys compare equal. Lines that otherwise compare equal are ordered 
with all bytes significant. 

EXAMPLES 

Sort the contents of infile with the second field as the sort key: 
sort +1-2 infile 

Sort, in reverse order, the contents of infilel and infile! , placing the output 
in outfile and using the first character of the second field as the sort key: 

sort -r -o outfile +1.0 -1.2 infilel infile2 

Sort, in reverse order, the contents of infilel and infilel using the first non- 
blank character of the second field as the sort key: 

sort -r +1.0b -1.1b infilel infile2 

Print the password file [passwd(4)] sorted by the numeric user ID (the third 
colon-separated field): 

sort -t: +2n -3 /etc/passwd 

Print the lines of the already sorted file infile, suppressing all but the first 
occurrence of lines having the same third field (the options -um with just 
one input file make the choice of a unique representative from a set of equal 
lines predictable): 

sort -um +2-3 infile 

FILES 

/usr /tmp /stm??? 

SEE ALSO 

comm(l), join(l), uniq(l). 

WARNINGS 

Comments and exits with non-zero status for various trouble conditions (for 
example, when input lines are too long), and for disorder discovered under 
the -c option. 

When the last line of an input file is missing a new-line character, sort 
appends one, prints a warning message, and continues. 

sort does not guarantee preservation of relative line ordering on equal keys. 
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NAME 

spell, hashmake, spellin, hashcheck - find spelling errors 
SYNOPSIS 

spell [ -V ] [ -b ] [ -X ] [ -1 ] [ +local_file ] [ files ] 
/usr /lib /spell /hashmake 
/usr/lib/spell/spellin n 
/usr /lib /spell /hashcheck spelling—list 
DESCRIPTION 

The spell command collects words from the named files and looks them up 
in a spelling list. Words that neither occur among nor are derivable (by 
applying certain inflections, prefixes, and/or suffixes) from words in the 
spelling list are printed on the standard output. If no files are named, words 
are collected from the standard input. 

The spell command ignores most troff(l), tbl(l), and eqn(l) constructions. 

Under the -v option, all words not literally in the spelling list are printed, 
and plausible derivations from the words in the spelling list are indicated. 

Under the -b option, British spelling is checked. Besides preferring centre, 
colour, programme, speciality, travelled, etc., this option insists upon -ise in 
words like standardise . 

Under the -x option, every plausible stem is printed with = for each word. 

By default, spell [like deroff(l)] follows chains of included files [.so and .nx 
troff(l) requests], unless the names of such included files begin with 
/usr/lib. Under the -1 option, spell will follow the chains of all included 
files. 

Under the +local—file option, words found in local— file are removed from 
s;7^//'s output. Local— file is the name of a user-provided file that contains a 
sorted list of words, one per line. With this option, the user can specify a 
set of words that are correct spellings (in addition to spell's own spelling 
list) for each job. 

The spelling list is based on many sources, and while more haphazard than 
an ordinary dictionary, is also more effective with respect to proper names 
and popular technical words. Coverage of the specialized vocabularies of 
biology, medicine, and chemistry is light. 

Pertinent auxiliary files may be specified by name arguments, indicated 
below with their default settings (see FILES ). Copies of all output are accu- 
mulated in the history file. The stop list filters out misspellings (e.g., 
thier=thy-y+ier) that would otherwise pass. 

Three routines help maintain and check the hash lists used by spell: 

hashmake Reads a list of words from the standard input and writes the 
corresponding nine-digit hash code on the standard output. 

spellin Reads n hash codes from the standard input and writes a 
compressed spelling list on the standard output. 
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hashcheck Reads a compressed spelling—list and recreates the nine-digit 
hash codes for all the words in it; it writes these codes on the 
standard output. 



FILES 

D_SPELL=/usr/lib/spell/hlist[ab] 

S_SPELL= /usr/lib /spell /hstop 
H_SPELL= /usr /lib /spell /spellhist 
/usr /lib /spell /spellprog 

SEE ALSO 

deroff(l), sed(l), sort(l), tee(l). 



hashed spelling lists, American & Brit- 
ish 

hashed stop list 
history file 
program 



BUGS 

The spelling list's coverage is uneven; new installations will probably wish 
to monitor the output for several months to gather local additions; typically, 
these are kept in a separate local file that is added to the hashed 
spelling— list via spellin . 
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NAME 

spline - interpolate smooth curve 

SYNOPSIS 

spline [ options ] 

DESCRIPTION 

The spline command takes pairs of numbers from the standard input as 
abscissas and ordinates of a function. It produces a similar set, which is 
approximately equally spaced and includes the input set, on the standard 
output. The cubic spline output has two continuous derivatives and suffi- 
cient points to look smooth when plotted, for example, by graph(lG). 

The following options are recognized, each as a separate argument: 

-a Supply abscissas automatically (they are missing from the input); 

spacing is given by the next argument, or is assumed to be 1 if next 
argument is not a number. 

-k The constant k used in the boundary value computation: 
is set by the next argument (default k = 0). 

-n Space output points so that approximately n intervals occur 
between the lower and upper x limits (default n = 100). 

-p Make output periodic, i.e., match derivatives at ends. First and last 
input values should normally agree. 

-X Next 1 (or 2) arguments are lower (and upper) x limits. Normally, 
these limits are calculated from the data. Automatic abscissas start 
at lower limit (default 0). 

SEE ALSO 

graph(lG). 

DIAGNOSTICS 

When data is not strictly monotone in x, spline reproduces the input 
without interpolating extra points. 

BUGS 

A limit of 1,000 input points is enforced silently. 
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NAME 

split - split a file into pieces 

SYNOPSIS 

split [ -n ] [ file [ name ] ] 

DESCRIPTION 

The split command reads file and writes it in «-line pieces (default 1000 
lines) onto a set of output files. The name of the first output file is name 
with aa appended, and so on lexicographically, up to zz (a maximum of 676 
files). Name cannot be longer than 12 characters. If no output name is 
given, X is default. 

If no input file is given, or if - is given instead, then the standard input file 
is used. 

SEE ALSO 

bfs(l), csplit(l). 



- 1 - 



STRACE(IM) 



(Networking Support Utilities) 



STRACE(IM) 



NAME 

strace - print STREAMS trace messages 

SYNOPSIS 

strace [ mid sid level ] ... 

DESCRIPTION 

The strace command without arguments writes all STREAMS event trace 
messages from all drivers and modules to its standard output. These mes- 
sages are obtained from the STREAMS log driver [log(7)]. If arguments are 
provided they must be in triplets of the form mid, sid, level, where mid is a 
STREAMS module id number, sid is a sub-id number, and level is a tracing 
priority level. Each triplet indicates that tracing messages are to be received 
from the given module/driver, sub-id (usually indicating minor device), and 
priority level equal to or less than the given level. The token all may be 
used for any member to indicate no restriction for that attribute. 

The format of each trace message output is: 

<seq> <time> <ticks> <level> <flags> <mid> <sid> <text> 

<seq> trace sequence number 

<time> time of message in hh:mm:ss 

<ticks> time of message in machine ticks since boot 

<level> tracing priority level 

<flags> E : message is also in the error log 
F : indicates a fatal error 
N : mail was sent to the system administrator 

<mid> module id number of source 

<sid> sub-id number of source 

<text> formatted text of the trace message 

Once initiated, strace will continue to execute until terminated by the user. 
EXAMPLES 

Output all trace messages from the module or driver whose module id is 41: 
strace 41 all all 

Output those trace messages from driver/module id 41 with sub-ids 0, 1, or 
2: 

strace 41 1 41 1 1 41 2 

Messages from sub-ids and 1 must have a tracing level less than or equal 
to 1. Those from sub-id 2 must have a tracing level of 0. 

CAVEATS 

Due to performance considerations, only one strace process is permitted to 
open the STREAMS log driver at a time. The log driver has a list of the tri- 
plets specified in the command invocation, and compares each potential 
trace message against this list to decide if it should be formatted and sent 
up to the strace process. Hence, long lists of triplets will have a greater 
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impact on overall STREAMS performance. Running strace will have the most 
impact on the timing of the modules and drivers generating the trace mes- 
sages that are sent to the strace process. If trace messages are generated fas- 
ter than the strace process can handle them, then some of the messages will 
be lost. This last case can be determined by examining the sequence 
numbers on the trace messages output. 

SEE ALSO 

log(7). 

STREAMS Programmer's Guide. 
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NAME 

strclean - STREAMS error logger cleanup program 

SYNOPSIS 

strclean [ -d logdir ] [-a age ] 

DESCRIPTION 

The strclean command is used to clean up the STREAMS error logger direc- 
tory on a regular basis [for example, by using cron(lM)]. By default, all files 
with names matching error.* in /usr/adm/streams that have not been 
modified in the last 3 days are removed. A directory other than 
/usr/adm/streams can be specified using the -d option. The maximum 
age in days for a log file can be changed using the -a option. 

EXAMPLE 

strclean -d /usr/adm/streams -a 3 
has the same result as running strclean with no arguments. 

NOTES 

The strclean command is typically run from cron(lM) on a daily or weekly 
basis. 

FILES 

/usr /adm /streams /error.* 

SEE ALSO 

cron(lM), strerr(lM). 
STREAMS Programmer's Guide. 
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NAME 

strerr - STREAMS error logger daemon 

SYNOPSIS 

strerr 

DESCRIPTION 

The strerr routine receives error log messages from the STREAMS log driver 
Vog{7)] and appends them to a log file. The error log files produced reside 
in the directory /usr/adm/streamis, and are named mot.mm'dd, where mm 
is the month and dd is the day of the messages contained in each log file. 

The format of an error log message is: 

<seq> <time> <ticks> <flags> <mid> <sid> <text> 

<seq> error sequence number 
<time> time of message in hh:mm:ss 

<ticks> time of message in machine ticks since boot priority level 

<flags> T : the message was also sent to a tracing process 
F : indicates a fatal error 
N : send mail to the system administrator 

<mid> module id number of source 

<sid> sub-id number of source 

<text> formatted text of the error message 

Messages that appear in the error log are intended to report exceptional 
conditions that require the attention of the system administrator. Those 
messages which indicate the total failure of a STREAMS driver or module 
should have the F flag set. Those messages requiring the immediate atten- 
tion of the administrator will have the N flag set, which causes the error 
logger to send the message to the system administrator via mail(l). The 
priority level usually has no meaning in the error log but will have meaning 
if the message is also sent to a tracer process. 

Once initiated, strerr will continue to execute until terminated by the user. 
Commonly, strerr would be executed asynchronously. 

CAVEATS 

Only one strerr process at a time is permitted to open the STREAMS log 
driver. 

If a module or driver is generating a large number of error messages, run- 
ning the error logger will cause a degradation in STREAMS performance. If a 
large burst of messages are generated in a short time, the log driver may not 
be able to deliver some of the messages. This situation is indicated by gaps 
in the sequence numbering of the messages in the log files. 

FILES 

/usr/adm /streams / error. mm-dd 

SEE ALSO 

log(7). 

STREAMS Programmer's Guide. 
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NAME 

strings - find the printable strings in an object file 

SYNOPSIS 

strings [-] [-a] [-o] [ -number ] file ... 

DESCRIPTION 

strings looks for ASCII strings in a binary file. A string is any sequence of 
four or more printing characters ending with a newline or a null character. 
Unless the - flag is given, strings only looks in the initialized data space of 
object files. If the -o flag is given, then each string is preceded by its 
decimal offset in the file, -a works the same as the - flag. If the -number 
flag is given, then number is used as the minimum string length rather than 
4. 

strings is useful for identifying random object files. 

SEE ALSO 

hd(l) 

CREDIT 

This utility was developed at the University of California at Berkeley and is 
used with permission. 
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NAME 

stty - set the options for a terminal 

SYNOPSIS 

stty [ -a ] [ -g ] [ options ] 

DESCRIPTION 

The stty command sets certain terminal I/O options for the device that is the 
current standard input; without arguments, it reports the settings of certain 
options. 

In this report, if a character is preceded by a caret (^J, then the value of that 
option is the corresponding CTRL character (e.g., "*h" is CTRL-h ; in this 
case, recall that CTRL-h is the same as the "backspace" key.) The sequence 
" means that an option has a null value. For example, normally stty -a 
will report that the value of swtch is "^'"; however, if shl{l) or layers{l) has 
been invoked, stty -a will have the value " z". 

-a reports all of the option settings; 

-g reports current settings in a form that can be used as an argument 
to another stty command. 

Options in the last group are implemented using options in the previous 
groups. Note that many combinations of options make no sense, but no 
sanity checking is performed. The options are selected from the following: 

Control Modes 

parenb (-parenb) enable (disable) parity generation and detection. 

parodd (-parodd) select odd (even) parity. 

cs5 cs6 cs7 cs8 select character size [see termio{7)], 

hang up phone line immediately. 

110 300 600 1200 1800 2400 4800 9600 19200 38400 

Set terminal baud rate to the number given, if possi- 
ble. (All speeds are not supported by all hardware 
interfaces.) 

hang up (do not hang up) Dataphone data set connec- 
tion on last close, 
same as hupcl (-hupcl). 
use two (one) stop bits per character, 
enable (disable) the receiver, 
assume a line without (with) modem control, 
block (do not block) output from a non-current layer. 

ignore (do not ignore) break on input, 
signal (do not signal) INTR on break, 
ignore (do not ignore) parity errors, 
mark (do not mark) parity errors [see termio{7)]. 
enable (disable) input parity checking, 
strip (do not strip) input characters to seven bits, 
map (do not map) NL to CR on input. 



hupcl (-hupcl) 

hup (-hup) 
cstopb (-cstopb) 
cread (-cread) 
clocal (-clocal) 
loblk (-loblk) 

Input Modes 

ignbrk (-ignbrk) 
brkint (-brkint) 
ignpar (-ignpar) 
parmrk (-parmrk) 
inpck (-inpck) 
istrip (-istrip) 
inlcr (-inlcr) 
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igncr (-igncr) 
icrnl (-icrnl) 
iuclc (-iuclc) 

ixon (-ixon) 



ixany (-ixany) 
ixoff (-ixoff) 



Output Modes 
opost (-opost) 

olcuc (-olcuc) 

onlcr (-onlcr) 
ocrnl (-ocrnl) 
onocr (-onocr) 
onlret (-onlret) 

ofill (-ofill) 
ofdel (-ofdel) 
crO crl cr2 cr3 
nlO nil 

tabO tabl tab2 tab3 
bsO bsl 
ffOffl 
vtO vtl 

Local Modes 
isig (-isig) 

icanon (-icanon) 

xcase (-xcase) 

echo (-echo) 
echoe (-echoe) 



echok (-echok) 
Ifkc (-Ifkc) 
echonl (-echonl) 
noflsh (-noflsh) 



ignore (do not ignore) CR on input. 

map (do not map) CR to NL on input. 

map (do not map) uppercase alphabetics to lowercase 

on input. 

enable (disable) START/STOP output control. Output 
is stopped by sending an ASCII DC3 and started by 
sending an ASCII DCl. 

allow any character (only DCl) to restart output, 
request that the system send (not send) START/STOP 
characters when the input queue is nearly empty/full. 



post-process output (do not post-process output; 
ignore all other output modes). 

map (do not map) lowercase alphabetics to upper case 
on output. 

map (do not map) NL to CR-NL on output. 

map (do not map) CR to NL on output. 

do not (do) output CRs at column zero. 

on the terminal NL performs (does not perform) the 

CR function. 

use fill characters (use timing) for delays, 
fill characters are DHLs (NULs). 

select style of delay for carriage returns [see termio(7)]. 
select style of delay for line-feeds [see termio(7)]. 
select style of delay for horizontal tabs [see termio(7)]. 
select style of delay for backspaces [see termio{7)]. 
select style of delay for form-feeds [see termio(7)]. 
select style of delay for vertical tabs [see termio(7)]. 



enable (disable) the checking of characters against the 
special control characters INTR, QUIT, and SWTCH. 
enable (disable) canonical input (ERASE and KILL pro- 
cessing). 

canonical (unprocessed) uppercase/lowercase presen- 
tation. 

echo back (do not echo back) every character typed, 
echo (do not echo) ERASE character as a backspace- 
space-backspace string. Note: this mode will erase 
the ERASEed character on many CRT terminals; how- 
ever, it does not keep track of column position and, as 
a result, may be confusing on escaped characters, 
tabs, and backspaces. 

echo (do not echo) NL after KILL character, 
the same as echok (-echok); obsolete, 
echo (do not echo) NL. 

disable (enable) flush after INTR, QUIT, or SWTCH. 
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stwrap (-stwrap) 
stflush (-stflush) 
stappl (-stappl) 



Control Assignments 

control-character c 



disable (enable) truncation of lines longer than 79 
characters on a synchronous line, 
enable (disable) flush on a synchronous line after 
every write (2). 

use application mode (use line mode) on a synchro- 
nous line. 



set control-character to c, where control-character is 
erase, kill, intr, quit, swtch, eof, eol, ctab, min, or 
time [ctab is used with -stappl; min and time are 
used with -icanon; see termio{7)]. If c is preceded by 
an (escaped from the shell) caret (^), then the value 
used is the corresponding CTRL character (e.g., "^d" is 
a CTRL-d); is interpreted as DEL and is 

interpreted as undefined, 
line i set line discipline to i (0 < f < 127 ). 

Combination Modes 

evenp or parity enable parenb and cs7. 

oddp enable parenb, cs7, and parodd. 

-parity, -evenp, or -oddp 

disable parenb, and set cs8. 

raw (-raw or cooked) 

enable (disable) raw input and output (no ERASE, 
KILL, INTR, QUIT, SWTCH, EOT, or output post pro- 
cessing). 

unset (set) icrnl, onlcr. In addition -nl unsets inlcr, 
igncr, ocrnl, and onlret. 
set (unset) xcase, iuclc, and olcuc. 
same as lease (-lease). 

preserve (expand to spaces) tabs when printing, 
reset ERASE and KILL characters back to normal # and 
@ 

resets all modes to some reasonable values, 
set all modes suitable for the terminal type term, 
where term is one of tty33, tty37, vt05, tn300, ti700, 
or tek. 

Control Modes for the Video Monitor 

Selects the monochrome display as the output device for the 
console screen. This mode is valid if a standard monochrome 
adapter is present or if a standard enhanced graphics adapter 
(EGA) is present and the EGA is currently in one of the mono- 
chrome display modes. 

Selects a standard regular color display as the output device for 
the console screen. This mode is valid if a color graphics adapter 
is present or if a standard EGA is present and is currently in one 
of the color graphics compatibility modes. 



nl (-nl) 

lease (-lease) 
LCASE (-LCASE) 
tabs (-tabs or tab3) 
ek 

sane 

term 



mono 



color 
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enhanced Selects the enhanced color display as the output device for the 
console screen. This mode is valid if an EGA is present and is 
currently in a non -monochrome display mode. 
Control Modes for the Attached Display Devices 

B40x25 Selects 40x25 (40 columns x 25 rows) black and white text display 
mode. 

C40x25 Selects 40x25 color text display mode. 
B80x25 Selects 80x25 black and white text display mode. 
C80x25 Selects 80x25 color display text mode. 
BG320 Selects 320x200 black and white graphics display mode. 
CG320 Selects 320x200 color graphics display mode. 
BG640 Selects 640x200 black and white graphics display mode. 
The keyboard and display control modes above are valid for the following 
configurations: standard color graphics adapter (CGA) attached to an stan- 
dard regular color display; standard enhanced graphics adapter (EGA) 
(modes 0-6) attached to a standard regular color display or standard 
enhanced color display. 
CG320_D 

Selects EGA support for 320x200 graphics display mode (EGA 
mode D). 

CG640_E ^ ^ 

Selects EGA support for 640x200 graphics display mode (EGA 

mode E). 

The two options above are only valid when an EGA is attached to a stan- 
dard regular color display or an enhanced color display. 
EGAMONO80x25 

Selects EGA Mode 7 as the display mode. Emulates the support 
provided by the standard monochrome display adapter. 
EGAMONOAPA 

Selects EGA support for 640x350 graphics display mode (EGA 

mode F). 
ENHMONOAPA2 

Selects EGA mode F*. 
The three options above are only valid when a standard EGA is attached to 
an IBM monochrome display. 

ENH_B40x25 , ^ . 

Selects enhanced EGA support for 40x25 black and white text 
display mode (EGA mode 0*). 
ENHL_C40x25 

Selects enhanced EGA support for 40x25 color text display mode 
(EGA mode 1*). 

ENH_B80x25 , ^ , . 

Selects enhanced EGA support for 80x25 black and white text 
display mode (EGA mode 2*). 
ENH_C80x25 ^ , 

Selects enhanced EGA support for 80x25 color text display mode 

(EGA mode 3*). 

ENHLB80x43 ^ ^ . 

Selects enhanced EGA support for 80x43 black and white text 

display mode. 



- 4 - 



STTY(l) 



(Base System) 



STTY(l) 



ENH_C80x43 

Selects enhanced EGA support for 80x43 color text display mode. 
CG640X350 

Selects EGA support for 640x350 graphics display mode (EGA 

mode 10). 
ENH_CG640 

Selects EGA mode 10*. 
The options above are only valid when a standard EGA is attached to a 
standard enhanced color display. 
MCAMODE 

Reinitializes the monochrome graphics adapter. 
ENH_CGA 

Selects CGA hardware emulation, when an AT&T Super- Vu video 
controller is attached. 

SEE ALSO 

tabs(l), termio(7). 

ioctl(2) in the Programmer's Reference Manual. 
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NAME 

su - become super-user or another user 

SYNOPSIS 

su [ - ] [ name [ arg . . . ] ] -c -r 

DESCRIPTION ^ . u 1 . 

The su command allows one to become another user without loggmg ott. 
The default user name is root (i.e., super-user). 

To use sw, the appropriate password must be supplied (unless one is already 
root). If the password is correct, su will execute a new shell with the real 
and effective user ID set to that of the specified user. The new shell will be 
the optional program named in the shell field of the specified user's pass- 
word file entry [see passwd(4)l or /bin/sh if none is specified [see sh{l)]. 
To restore normal user ID privileges, type an EOF ( CTRL-d ) to the new 
shell. 

Any additional arguments given on the command line are passed to the 
program invoked as the shell. When using programs like s/i(l), an arg of 
the form -c string executes string via the shell and an arg of -r will give the 
user a restricted shell. 

The following statements are true only if the optional program named in the 
shell field of the specified user's password file entry is like sh(l). If the first 
argument to su is a -, the environment will be changed to what would be 
expected if the user actually logged in as the specified user. This is done by 
invoking the program used as the shell with an argO value whose first char- 
acter is -, thus causing first the system's profile (/etc/profile) and then the 
specified user's profile (.profile in the new HOME directory) to be executed 
Otherwise, the environment is passed along with the possible exception of 
$PATH, which is set to /bin:/etc:/usr/bin for root. Note that if the 
optional program used as the shell is /bin/sh, the user's profile can check 
ar^O for -sh or -su to determine if it was invoked by logtn{l) or sm(1M), 
respectively. If the user's program is other than /bin/sh, then .profile is 
invoked with an argO of -program by both login(l) and s«(lM). 
All attempts to become another user using su are logged in the log file 
/usr/adm/sulog. 

EXAMPLES ^^^^^^ ^^^^ ^.^ ^^.j^ retaining your previously exported environment, 
execute: 

/bin/su bin 

To become user bin but change the environment to what would be 
expected if bin had originally logged in, execute: 
/bin/su - bin 

To execute command with the temporary environment and permissions of 
user bin, type: 

/bin/su - bin -c "command args" 
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FILES 

/etc/passwd 
/etc/profile 
$HOME/.profile 
/usr/adm/sulog 

SEE ALSO 

env(l), login(l), sh(l). 

passwd(4), profile(4), environ(5) in the Programmer's Reference Manual 



system's password file 
system's profile 
user's profile 
log file 
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NAME 

sulogin - access single-user mode 

SYNOPSIS 

sulogin 

DESCRIPTION 

sulogin is automatically invoked by init when the system is first started. It 
prompts the user to type the root password to enter system maintenance 
mode (single-user mode) or to type CTRL-D for normal startup (multi-user 
mode), sulogin should never be directly invoked by the user. 

FILES 

/etc/sulogin 

SEE ALSO 

init(M). 
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NAME 

sum - print checksum and block count of a file 

SYNOPSIS 

sum [ -r ] file 

DESCRIPTION 

The sum command calculates and prints a 16-bit checksum for the named 
file and prints the number of blocks in the file. It is typically used to look 
for bad spots or to validate a file communicated over some transmission 
line. The option -r causes an alternate algorithm to be used in computing 
the checksum. 

SEE ALSO 

wc(l). 

DIAGNOSTICS 

"Read error" is indistinguishable from end of file on most devices; check the 
block count. 
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NAME 

swap - swap administrative interface 
SYNOPSIS 

/etc/swap -a swapdev swaplow swaplen 
/etc/swap -d swapdev swaplow 
/etc/swap -1 

DESCRIPTION 

The swap command provides a method of adding, deleting, and monitoring 
the system swap areas used by the memory manager. The following 
options are recognized: 

-a Add the specified swap area, swapdev is the name of the block special 
device, e.g., /dev/dsk/lsO. swaplow is the offset in 512-byte blocks 
into the device where the swap area should begin, swaplen is the 
length of the swap area in 512-byte blocks. This option can only be 
used by the super-user. Swap areas are normally added by the system 
start-up routine /etc/rc when going into multiuser mode. 

-d Delete the specified swap area, swapdev is the name of a block special 
device, e.g., /dev/dsk/lsO. swaplow is the offset in 512-byte blocks 
into the device where the swap area should begin. This option can 
only be used by the super-user. 

-1 List the status of all the swap areas. The output has four columns: 

DEV The swapdev special file for the swap area if one can be found 
in the /dev/dsk or /dev directories, and its major/minor dev- 
ice number in decimal. 

LOW The swaplow value for the area in 512-byte blocks. 

LEN The swaplen value for the area in 512-byte blocks. 

FREE The number of free 512-byte blocks in the area. 

WARNINGS 

No check is done to see if a swap area being added overlaps with an exist- 
ing swap area or file system. 
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NAME 

sync - update the super block 

SYNOPSIS 

sync 

DESCRIPTION 

The sync command executes the sync system primitive. If the system is to 
be stopped, sync must be called to insure file system integrity. It will flush 
all previously unwritten system buffers out to disk, thus assuring that all file 
modifications up to that point will be saved. See sync (2) for details. 

NOTE 

If you have done a write to a file on a remote machine in a Remote File 
Sharing environment, you cannot use sync to force buffers to be written out 
to disk on the remote machine, sync will only write local buffers to local 
disks. 

SEE ALSO 

sync(2) in the Programmer's Reference Manual. 
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NAME 

sysdef - output values of tunable parameters 
SYNOPSIS 

/etc/sysdef [ system__namelist [ conf ] ] 
DESCRIPTION 

The sysdef command outputs the values of all tunable parameters. It gen- 
erates the output by analyzing the named operating system file 
(system— namelist) and extracting the configuration information from the 
name list itself. 

FILES 

/unix default operating system file (where the system namelist 

is) 

/etc/conf/* default directory containing master files 
SEE ALSO 

nlist(3C) in the Programmer's Reference Manual. 

DIAGNOSTICS 

internal name list overflow 

if the master table contains more than an internally specified 
number of entries for use by nlist (3C). 
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NAME 

tabs - set tabs on a terminal 

SYNOPSIS 

tabs [tabspec] [-Ttype] [+mn] 

DESCRIPTION 

The tabs command sets the tab stops on the user's terminal according to the 
tab specification tabspec, after clearing any previous settings. The user's ter- 
minal must have remotely-settable hardware tabs. 

tabspec Four types of tab specification are accepted for tabspec. They are 
described below: canned (-code), repetitive (-n), arbitrary 
(nl,n2,...), and file {—file). If no tabspec is given, the default value 
is -8, i.e., UNIX system "standard" tabs. The lowest column 
number is 1. Note that for tabs, column 1 always refers to the left- 
most column on a terminal, even one whose column markers begin 
at 0, e.g., the DASI 300, DASI 300s, and DASI 450. 

-code Use one of the codes listed below to select a canned set of tabs. 
The legal codes and their meanings are as follows: 

-a 1,10,16,36,72 

Assembler, IBM S/370, first format 

-a2 1,10,16,40,72 

Assembler, IBM S/370, second format 

-c 1,8,12,16,20,55 

COBOL, normal format 

-c2 1,6,10,14,49 

COBOL compact format (columns 1-6 omitted). Using this 
code, the first typed character corresponds to card column 
7, one space gets you to column 8, and a tab reaches 
column 12. Files using this tab setup should include a for- 
mat specification as follows [see fspec(4i)]: 
<:t-c2 m6 s66 d:> 

-c3 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 

COBOL compact format (columns 1-6 omitted), with more 
tabs than -c2. This is the recommended format for COBOL. 
The appropriate format specification is [see fspec{^)\\ 
<:t-c3 m6 s66 d:> 

-f 1,7,11,15,19,23 
FORTRAN 

-p 1,5,9,13,17,21,25,29,33,37,41,45,49,53,57,61 

PL/I 
-s 1,10,55 

SNOBOL 
-u 1,12,20,44 

UNI VAC 1100 Assembler 
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-n A repetitive specification requests tabs at columns l+2*n, etc. 

Of particular importance is the value 8: this represents the UNIX 
system "standard" tab setting, and is the most likely tab setting to 
be found at a terminal. Another special case is the value 0, imply- 
ing no tabs at all. 

nl,n2,... The arbitrary format permits the user to type any chosen set of 
numbers, separated by commas, in ascending order. Up to 40 
numbers are allowed. If any number (except the first one) is pre- 
ceded by a plus sign, it is taken as an increment to be added to the 
previous value. Thus, the formats 1,10,20,30, and l,10,-hlO,+10 are 
considered identical. 

—file If the name of a file is given, tabs reads the first line of the file, 
searching for a format specification [see fspec{4)\ If it finds one 
there, it sets the tab stops according to it, otherwise it sets them as 
-8. This type of specification may be used to make sure that a 
tabbed file is printed with correct tab settings, and would be used 
with the pr(V) command: 

tabs — file; pr file 

Any of the following also may be used; if a given flag occurs more than 
once, the last value given takes effect: 

'Ttype tabs usually needs to know the type of terminal in order to set tabs 
and always needs to know the type to set margins, type is a name 
listed in term(5). If no -T flag is supplied, tabs uses the value of 
the environment variable TERM. If TERM is not defined in the 
environment [see environ(5)], tabs tries a sequence that will work 
for many terminals. 

+mn The margin argument may be used for some terminals. It causes 
all tabs to be moved over n columns by making column n+1 the 
left margin. If +m is given without a value of n, the value 
assumed is 10. For a TermiNet, the first value in the tab list should 
be 1, or the margin will move even further to the right. The nor- 
mal (leftmost) margin on most terminals is obtained by +mO. The 
margin for most terminals is reset only when the +m flag is given 
explicitly. 

Tab and margin setting is performed via the standard output. 
EXAMPLES 

tabs -a example using -code (canned specification) to set tabs to the 

settings required by the IBM assembler: columns 1, 10, 16, 
36, 72. 

tabs -8 example of using -n (repetitive specification), where n is 8, 

causes tabs to be set every eighth position: 
1+(1*8), l+(2*8), ... which evaluate to columns 9, 17, ... 

tabs 1,8,36 example of using nl,n2,... (arbitrary specification) to set tabs 
at columns 1, 8, and 36. 
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tabs — $HOME/fspec.list/atl4425 

example of using —file {file specification) to indicate that tabs 
should be set according to the first line of 
$HOME/fspec.list/att4425 [see fspec(4)]. 

DIAGNOSTICS 

illegal tabs when arbitrary tabs are ordered incorrectly 

illegal increment when a zero or missing increment is found in an arbi- 
trary specification 
unknown tab code when a canned code cannot be found 
can't open if —file option used and file can't be opened 

file indirection if —file option used and the specification in that file 
points to yet another file. Indirection of this form is not 
permitted 

SEE ALSO 

newform(l), pr(l), tput(l). 

fspec(4), terminfo(4), environ(5), term(5) in the Programmer's Reference 
Manual. 

NOTE 

There is no consistency among different terminals regarding ways of clear- 
ing tabs and setting the left margin. 

tabs clears only 20 tabs (on terminals requiring a long sequence), but is wil- 
ling to set 64. 

WARNING 

The tabspec used with the tabs command is different from the one used with 
the newform{\) command. For example, tabs -8 sets every eighth position; 
whereas newform -i-8 indicates that tabs are set every eighth position. 
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NAME 

tail - display the last part of a file 

SYNOPSIS 

tail [ ±[number][lbc[f] ] ] [ file ] 

DESCRIPTION 

The tail command copies the named file to the standard output beginning at 
a designated place. If no file is named, the standard input is used. 

Copying begins at distance -\-number from the beginning or -number from 
the end of the input (if number is null, the value 10 is assumed). Number is 
counted in units of lines, blocks, or characters, according to the appended 
option 1, b, or c. When no units are specified, counting is by lines. 

With the -f ("follow'') option, if the input file is not a pipe, the program 
will not terminate after the line of the input file has been copied, but will 
enter an endless loop, wherein it sleeps for a second and then attempts to 
read and copy further records from the input file. Thus it may be used to 
monitor the growth of a file that is being written by some other process. 
For example, the command: 

tail -f fred 

will print the last ten lines of the file fred, followed by any lines that are 
appended to fred between the time tail is initiated and killed. As another 
example, the command: 

tail -15cf fred 

will print the last 15 characters of the file fred, followed by any lines that 
are appended to fred between the time tail is initiated and killed. 

SEE ALSO 

dd(lM). 

BUGS 

Tails relative to the end of the file are stored in a buffer, and thus are lim- 
ited in length. Various kinds of anomalous behavior may happen with 
character special files. 

WARNING 

The tail command will only tail the last 4096 bytes of a file regardless of its 
line count. 
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NAME 

tapecntl - tape control for QIC-24/QIC-02 tape device 

SYNOPSIS 

tapecntl [ -etrw ] [ -p arg ] 

DESCRIPTION 

tapecntl will send the optioned commands to the tape device driver sub- 
device /dev/rmt/cOsO for all commands except "position/' which will use 
sub-device /dev/rmt/cOsOn using the ioctl command function. Sub-device 
/dev/rmt/cOsO provides a rewind on close capability, while 
/dev/rmt/cOsOn allows for closing of the device without rewind. Error 
messages will be written to standard error. 



-w rewind tape 
-p[w] position tape to "end of file" mark - n 

Erasing the tape causes the erase bar to be activated while moving the tape 
from end to end, causing all data tracks to be erased in a single pass over 
the tape. 

Retensioning the tape causes the tape to be moved from end to end, thereby 
repacking the tape with the proper tension across its length. 

Reset of the tape device initializes the tape controller registers and positions 
the tape at the beginning of the tape mark (BOT). 

Rewinding the tape will move the tape to the BOT. 

Positioning the tape command requires an integer argument. Positioning 
the tape will move the tape forward relative to its current position to the 
end of the specified file mark. The positioning option used with an argu- 
ment of zero will be ignored. Illegal or out-of-range value arguments to the 
positioning command will leave the tape positioned at the end of the last 
valid file mark. 

Options may be used individually or strung together with selected options 
being executed sequentially from left to right in the command line. 



-r 



-e 
-t 



erase tape 
retension tape 
reset tape device 



FILES 



/usr /lib /tape /tapecntl 
/dev /rmt /cOsOn 
/dev/rmt/cOsO 
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NOTES 

Exit codes and their meanings are as follows: 

exit (1) device function could not initiate properly due to miscon- 
nected cables or poorly inserted tape cartridge. 

exit (2) device function failed to complete properly due to unrecov- 
erable error condition, either in the command setup or due 
to mechanical failure. 

exit (3) device function failed due to the cartridge being write pro- 
tected or to the lack of written data on the tape. 

exit (4) device /dev/rmt/cOsOn or /dev/rmt/cOsO failed to open 
properly due to already being opened or claimed by 
another process. 
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NAME 

tar - file archiver 

SYNOPSIS 

tar [ key ] [ files ] 

DESCRIPTION 

tar saves and restores files to and from an archive medium, which is typi- 
cally a storage device such as a floppy disk, a tape, or a regular file. Its 
actions are controlled by the key argument. The key is a string of characters 
containing at most one function letter and possibly one or more function 
modifiers. Valid function letters are c, t, x, u, and r. Other arguments to 
the command are files (or directory names) specifying which files are to be 
backed up or restored. In all cases, appearance of a directory name refers to 
the files and (recursively) subdirectories of that directory. 

The function portion of the key is specified by one of the following letters: 

r The named files are written to the end of the archive. 

X The named files are extracted from the archive. If a named file 

matches a directory whose contents have been written onto the 
archive, this directory is (recursively) extracted. The owner, modif- 
ication time, and mode are restored (if possible). If no files argu- 
ment is given, the contents of the archive are extracted. Note that 
if several files with the same name are on the archive, the last file 
overwrites all earlier ones. 

t The names of the specified files are listed each time that they occur 

on the archive. If no files argument is given, all the names on the 
archive are listed. 

u The named files are added to the archive if they are not already 

there, or if they have been modified since last written on that 
archive. 

c Creates a new archive; writing begins at the beginning of the 

archive, instead of after the last file. 

e Prevents files from being split across volumes (tapes or floppy 

disks). If there is not enough room on the present volume for a 
given file, tar prompts for a new volume. This is only valid when 
the -k option is also specified on the command line. 

The following characters may be used in addition to the letter that selects 
the desired function: 

0,...,7 This modifier selects the drive on which the archive is mounted. 
The default drive is 1. 
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Normally, tar does its work silently. The v (verbose) option causes 
it to type the name of each file it treats, preceded by the function 
letter. With the t function, v gives more information about the 
archive entries than just the name. 

Causes the extracted files to assume the owner and group ID of the 
user running the program rather than those on the archive tape. 

Causes tar to print the action to be taken, followed by the name of 
the file, and then wait for the user's confirmation. If a word begin- 
ning with 'y' is given, the action is performed. Any other input 
means "no." 

Causes tar to use the next argument as the name of the archive 
instead of the default device in /etc/tar/default. If the name of 
the file is a dash (-), tar writes to the standard output or reads 
from the standard input, whichever is appropriate. Thus, tar can 
be used as the head or tail of a pipeline. Tar can also be used to 
move hierarchies with the command: 

cd fromdir; tar cf - . I (cd todir; tar xf -) 

Causes tar to use the next argument as the blocking factor for 
archive records. The default is 2, the maximum is 20. This option 
should only be used with raw magnetic tape archives (see f above). 
The number of bytes in a block is BSIZE as defined in 
/usr/mclude/sys/param.h. 

Causes tar to use the next argument as the name of a file from 
which succeeding arguments are taken. The dash (-) is not a valid 
argument here. 

Tells tar to print an error message if it cannot resolve all of the 
links to the files being backed up. If 1 is not specified, no error 
messages are printed. 

Tells tar not to restore the modification times. The modification 
time of the file will be the time of extraction. 

Causes tar to use the next argument as the size of an archive 
volume in kilobytes. The minimum value allowed is 250. This 
option is useful when the archive is not intended for a magnetic 
tape device, but for some fixed size device, such as floppy disk (See 
f above). Very large files are split into "extents" across volumes. 
When restoring from a multivolume archive, tar only prompts for a 
new volume if a split file has been partially restored. 

Indicates the archive device is not a magnetic tape. The k option 
implies this. Listing and extracting the contents of an archive are 
sped because tar can seek over files it wishes to skip. Sizes are 
printed in kilobytes instead of tape blocks. 

Indicates that files are extracted using their original permissions. It 
is possible that a non-super-user may be unable to extract files 
because of the permissions associated with the files or directories 
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being extracted. 



EXAMPLES 



If the name of a floppy disk device is /dev/dsk/flql5dt, a tar format file 
can be created on this device by typing 

tar cvfk /dev/dsk/flql5dt 360 files 

where files are the names of files you want archived and 360 is the capacity 
of the floppy disk in kilobytes. Note that arguments to key letters are given 
in the same order as the key letters themselves; thus, the fk key letters have 
corresponding arguments, /dev/dsk/flql5dt and 360. Note that if a file is 
a directory, the contents of the directory are archived recursively. To print a 
listing of the archive, type 

tar tvf /dev/dsk/flql5dt 

At some later time you may want to extract the files from the floppy 
archive. You can do this by typing 

tar xvf /dev/dsk/flql5dt 

The above command extracts all files from the archive using the same path- 
names as those of the original archive. Because of this behavior, it is best to 
save archive files with relative pathnames rather than absolute ones since 
directory permissions may not let you read the files into the specified abso- 
lute directories. 

In the above examples, the v option is used to confirm the reading or writ- 
ing of archive files on the screen. Also, a normal file could be substituted 
for the floppy device, /dev/dsk/flql5dt, in the examples. 



/tmp/tar* 

SEE ALSO 

cpio(l), ls(l). 

DIAGNOSTICS 

Prints an error message about bad key characters and archive read/ write 
errors. 

Prints an error message if not enough memory is available to hold the link 
tables. 

NOTES 

There is no way to ask for the nth occurrence of a file. 
The u option can be slow. 

The b option should not be used with archives that are going to be updated. 
If the archive is on a disk file, the b option should not be used at all 
because updating an archive stored on a disk can destroy it. To update (r or 
u option) a tar archive, do not use raw magtape and do not use the b 
option. This applies both when updating and when first creating an archive. 



FILES 



/etc/default/tar 



Default devices 
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The limit on filename length is 100 characters. 

When archiving a directory that contains subdirectories, tar will only access 
those subdirectories that are within 17 levels of nesting. Subdirectories at 
higher levels will be ignored after tar displays an error message. 

Systems with IK byte file systems cannot specify raw disk devices unless 
the b option is used to specify an even number of blocks. This means that 
you cannot update a raw-mode disk partition. 

Don't do: 

tar xfF — 

This would imply taking two things from the standard input at the same 
time. 
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NAME 

tee - pipe fitting 

SYNOPSIS 

tee [ -i ] [ -a ] [ file ] ... 

DESCRIPTION 

The tee command transcribes the standard input to the standard output and 
makes copies in the files, 

-i ignore interrupts; 

-a causes the output to be appended to the files rather than overwrit- 
ing them. 
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NAME 

test - condition evaluation command 

SYNOPSIS 

test expr [expr] 

DESCRIPTION 

The test command evaluates the expression expr and, if its value is true, sets 
a zero (true) exit status; otherwise, a non-zero (false) exit status is set; test 
also sets a non-zero exit status if there are no arguments. When permis- 
sions are tested, the effective user ID of the process is used. 

All operators, flags, and brackets (brackets used as shown in the second 
SYNOPSIS line) must be separate arguments to the test command; normally 
these items are separated by spaces. 

The following primitives are used to construct expr: 



-r file true if file exists and is readable. 

-w file true if file exists and is writable. 

-X file true if file exists and is executable. 

-f file true if file exists and is a regular file. 

-d file true if file exists and is a directory. 

-c file true if file exists and is a character special file. 

-b file true if file exists and is a block special file. 

-p file true if file exists and is a named pipe (fifo). 

-u file true if file exists and its set-user-ID bit is set. 

-g file true if file exists and its set-group-ID bit is set. 

-k file true if file exists and its sticky bit is set. 

-s file true if file exists and has a size greater than zero. 

-t [ fildes ] true if the open file whose file descriptor number is fildes (1 by 
default) is associated with a terminal device. 

-z si true if the length of string si is zero. 

-n si true if the length of the string si is non-zero. 

si = s2 true if strings si and s2 are identical. 

si != s2 true if strings si and s2 are not identical. 

si true if si is not the null string. 

nl -eq n2 true if the integers nl and n2 are algebraically equal. Any of 
the comparisons -ne, -gt, -ge, -It, and -le may be used in 



place of -eq. 
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These primaries may be combined with the following operators: 
! unary negation operator, 

-a binary and operator. 

-o binary or operator (-a has higher precedence than -o). 

( expr ) parentheses for grouping. Notice also that parentheses are 
meaningful to the shell and, therefore, must be quoted. 

SEE ALSO 

find(l), sh(l). 

WARNING 

If you test a file you own (the -r, -w, or -x tests), but the permission tested 
does not have the owner bit set, a non-zero (false) exit status will be 
returned even though the file may have the group or other bit set for that 
permission. The correct exit status will be set if you are super-user. 

The = and != operators have a higher precedence than the -r through -n 
operators, and = and != always expect arguments; therefore, = and != can- 
not be used with the -r through -n operators. 

If more than one argument follows the -r through -n operators, only the 
first argument is examined; the others are ignored, unless a -a or a -o is the 
second argument. 
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NAME 

tic - terminfo compiler 

SYNOPSIS 

tic [-v[n]] [-C] file 

DESCRIPTION 

The tic command translates a terminfo(4:) file from the source format into the 
compiled format. The results are placed in the directory /usr/lib/terminfo. 
The compiled format is necessary for use with the library routines described 
in curses(3X). 

-vn (verbose) output to standard error trace information showing tic's 
progress. The optional integer n is a number from 1 to 10, 
inclusive, indicating the desired level of detail of information. If n 
is omitted, the default level is 1. If w is specified and greater than 
1, the level of detail is increased. 

-c only check file for errors. Errors in use= links are not detected. 

file contains one or more terminfo(4) terminal descriptions in source 
format [see terminfo{4)]. Each description in the file describes the 
capabilities of a particular terminal. When a VLse= entry -name field 
is discovered in a terminal entry currently being compiled, tic reads 
in the binary from /usr/lib/terminfo to complete the entry. 
(Entries created from file will be used first. If the environment 
variable TERMINFO is set, that directory is searched instead of 
/usr/lib/terminfo.) tic duplicates the capabilities in entry-name 
for the current entry, with the exception of those capabilities that 
explicitly are defined in the current entry. 

If the environment variable TERMINFO is set, the compiled results are 
placed there instead of /usr/lib/terminfo. 

FILES 

/usr/lib/terminfo/?/* compiled terminal description data base 
SEE ALSO 

curses(3X), term(4), terminfo(4) in the Programmer's Reference Manual. 
Chapter 10 in the Programmer's Guide. 

WARNINGS 

Total compiled entries cannot exceed 4096 bytes. The name field cannot 
exceed 128 bytes. 

Terminal names exceeding 14 characters will be truncated to 14 characters 
and a warning message will be printed. 

When the -c option is used, duplicate terminal names will not be diagnosed; 
however, when -c is not used, they will be. 
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BUGS 

To allow existing executables from the previous release of the UNIX system 
to continue to run with the compiled terminfo entries created by the new 
terminfo compiler, cancelled capabilities will not be marked as cancelled 
within the terminfo binary unless the entry name has a within it. (Such 
terminal names are only used for inclusion within other entries via a use= 
entry. Such names would not be used for real terminal names.) 

For example: 

4415+nl, kfl@, kf2@, .... 

4415+base, kfl=\EOc, kf2=\EOd, .... 

4415-nli4415 terminal without keys, 
use=4415+nl, use=4415+base. 

The above example works as expected; the definitions for the keys do not 
show up in the 4415-nl entry. However, if the entry 4415+nl did not have 
a plus sign within its name, the cancellations would not be marked within 
the compiled file and the definitions for the function keys would not be 
cancelled within 4415-nl. 

DIAGNOSTICS 

Most diagnostic messages produced by tic during the compilation of the 
source file are preceded with the approximate line number and the name of 
the terminal currently being worked on. 

mkdir ... returned bad status 

The named directory could not be created. 

File does not start with terminal names in column one 

The first thing seen in the file, after comments, must be the list of 
terminal names. 

Token after a lseek(2) not NAMES 

Somehow the file being compiled changed during the compilation. 

Not enough memory for use— list element 
or 

Out of memory 

Not enough free memory was available [malloc(3C) failed]. 

Can't open ... 

The named file could not be created. 

Error in writing ... 

The named file could not be written to. 

Can't link ... to ... 

A link failed. 

Error in re-reading compiled file ... 

The compiled file could not be read back in. 
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Premature EOF 

The current entry ended prematurely. 

Backspaced off beginning of line 

This error indicates something wrong happened within tic . 
Unknown Capability - 

The named invalid capability was found within the file. 

Wrong type used for capability "... " 

For example, a string capability was given a numeric value. 
Unknown token type 

Tokens must be followed by to cancel, for Booleans, for 

numbers, or for strings. 

bad term name 
or 

Line Illegal terminal name - 

Terminal names must start with a letter or digit 

The given name was invalid. Names must not contain white space 

or slashes, and must begin with a letter or digit. 

terminal name too long. 

An extremely long terminal name was found. 

terminal name too short. 

A one-letter name was found. 

filename too long, truncating to 

The given name was truncated to 14 characters due to UNIX system 
file name length limitations. 

defined in more than one entry. Entry being used is 
An entry was found more than once. 

Terminal name synonym for itself 

A name was listed twice in the list of synonyms. 

At least one synonym should begin with a letter. 

At least one of the names of the terminal should begin with a 
letter. 

Illegal character - 

The given invalid character was found in the input file. 

New-line in middle of terminal name 

The trailing comma was probably left off the list of names. 

Missing comma 

A comma was missing. 

Missing numeric value 

The number was missing after a numeric capability. 

NULL string value 

The proper way to say that a string capability does not exist is to 
cancel it. 
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Very long string found. Missing comma? 
self-explanatory 

Unknown option. Usage is: 

An invalid option was entered. 

Too many file names. Usage is: 
self-explanatory 

nonexistent or permission denied 

The given directory could not be written into. 

IS not a directory 
self-explanatory 

Permission denied 
access denied. 

Not a directory 

tic wanted to use the given name as a directory, but it already 
exists as a file 

SYSTEM ERROR!! Fork failed!!! 
A forkil) failed. 

Error in following up use-links. Either there is a loop in the links or they refer- 
ence nonexistent terminals. The following is a list of the entries involved: 

A terminfo(^) entry with a VLse=name capability either referenced a 
nonexistent terminal called name or name somehow referred back to 
the given entry. 
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NAME 

time - time a command 

SYNOPSIS 

time command 

DESCRIPTION 

The command is executed; after it is complete, time prints the elapsed time 
during the command, the time spent in the system, and the time spent in 
execution of the command. Times are reported in seconds. 

The times are printed on standard error. 

SEE ALSO 

times(2) in the Programmer's Reference Manual. 
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NAME 

timex - time a command; report process data and system activity 

SYNOPSIS 

timex [options] command 

DESCRIPTION 

The given command is executed; the elapsed time, user time and system 
time spent in execution are reported in seconds. Optionally, process 
accounting data for the cornmi^i^d and all its children can be listed or sum- 
marized, and total system activity during the execution interval can be 
reported. 

The output of timex is written on standard error. 
Options are: 

-p List process accounting records for command and all its children. 
This option works only if the process accounting software is 
installed. Suboptions f, h, k, m, r, and t modify the data items 
reported. The options are as follows: 



-f Print the fork /exec flag and system exit status columns in 
the output. 

-h Instead of mean memory size, show the fraction of total 
available CPU time consumed by the process during its 
execution. This ''hog factor" is computed as: 

(total CPU time)/(elapsed time). 

-k Instead of memory size, show total kcore-minutes, 

-m Show mean core size (the default). 

-r Show CPU factor: 

(user time/ (system- time 4- user-time)). 

-t Show separate system and user CPU times. The number 
of blocks read or written and the number of characters 
transferred are always reported. 

-o Report the total number of blocks read or written and total characters 
transferred by command and all its children. This option works only 
if the process accounting software is installed. 

-s Report total system activity (not just that due to command) that 
occurred during the execution interval of command. All the data 
items listed in sar(l^ are reported. 

SEE ALSO 

sar(l). 

WARNING 

Process records associated with command are selected from the accounting 
file /usr/adm/pacct by inference, since process genealogy is not available. 
Background processes having the same user-id, terminal-id, and execution 
time window will be spuriously included. 
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EXAMPLES 

A simple example: 

timex -ops sleep 60 

A terminal session of arbitrary complexity can be measured by timing a 
sub-shell: 

timex -opskmt sh 

session commands 

EOT 
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NAME 

touch - update access and modification times of a file 
SYNOPSIS 

touch [ -amc ] [ mmddhhmm[yy] ] files 
DESCRIPTION 

The touch command causes the access and modification times of each argu- 
ment to be updated. The file name is created if it does not exist. If no time 
is specified [see date{l)], the current time is used. The -a and -m options 
cause touch to update only the access or modification times, respectively 
(default is -am). The -c option silently prevents touch from creating the file 
if it did not previously exist. 

The return code from touch is the number of files for which the times could 
not be successfully modified (including files that did not exist and were not 
created). 

SEE ALSO 

date(l). 

utime(2) in the Programmer's Reference Manual, 



- 1 - 



TPLOT(IG) 



(Base System) 



TPLOT(IG) 



NAME 

tplot - graphics filters 

SYNOPSIS 

tplot [ -Tterminal [ -e raster ] ] 

DESCRIPTION 

This command reads plotting instructions [see plot (4)] from the standard 
input and in general produce, on the standard output, plotting instructions 
suitable for a particular terminal. If no terminal is specified, the environ- 
ment parameter $TERM [see environ(5)] is used. Known terminals are: 

300 DASI 300. 
300S DASI 300s. 
450 DASI 450. 
4014 Tektronix 4014. 

ver VERSATEC D1200A. This version of plot places a scan-converted 
image in /usr/tmp/raster$$ and sends the result directly to the 
plotter device, rather than to the standard output. The -e option 
causes a previously scan-converted file raster to be sent to the 
plotter. 

FILES 

/usr/lib/t300 

/usr/lib/t300s 

/usr/lib/t450 

/usr/lib/t4014 

/usr/lib/vplot 

/usr/tmp/raster$$ 

SEE ALSO 

plot(3X), plot(4), term(5) in the Programmer's Reference Manual 
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initialize a terminal or query terminfo data base 

] 



NAME 

tput 

SYNOPSIS 

tput [-Ttype] [-S] capname [parms 

tput [-Ttype] [-S] init 

tput [-Ttype] [-S] reset 

tput [-Ttype] [-S] longname 

DESCRIPTION 

The tput command uses the terminfo{4) data base to make the values of 
terminal-dependent capabilities and information available to the shell [see 
sh{l)], to initialize or reset the terminal, or return the long name of the 
requested terminal type, tput outputs a string if the attribute (capability 
name) is of type string, or an integer if the attribute is of type integer. If the 
attribute is of type Boolean, tput simply sets the exit code (0 for TRUE if the 
terminal has the capability, 1 for FALSE if it does not), and produces no out- 
put. Before using a value returned on standard output, the user should test 
the exit code [$?, see sh{l)] to be sure it is 0. (See EXIT CODES and DIAG- 
NOSTICS below.) For a complete list of capabilities and the capname associ- 
ated with each, see terminfo{4). 

-Ttype indicates the type of terminal. Normally, this option is unneces- 
sary because the default is taken from the environment variable 
TERM. If -T is specified, then the shell variables LINES and 
COLUMNS and the layer size [see layers{l)] will not be refer- 
enced. 

-S causes the capname to be read in from standard input instead of 

from the command line. 

capname indicates the attribute from the terminfo (4) data base. 

parms If the attribute is a string that takes parameters, the arguments 
parms will be inserted into the string. An all numeric argument 
will be passed to the attribute as a number. 

init If the terminfo(4) data base is present and an entry for the user's 

terminal exists (see -Ttype, above), the following will occur: (1) 
if present, the terminal's initialization strings will be output (isl, 
is2, is3, if, iprog), (2) any delays (e.g., new-line) specified in 
the entry will be set in the tty driver, (3) tabs expansion will be 
turned on or off according to the specification in the entry, and 
(4) if tabs are not expanded, standard tabs will be set (every 8 
spaces). If an entry does not contain the information needed 
for any of the four above activities, that activity will be silently 
skipped. 

reset Instead of putting out initialization strings, the terminal's reset 

strings will be output, if present (rsl, rs2, rs3, rf). If the reset 
strings are not present, but initialization strings are, the initiali- 
zation strings will be output. Otherwise, reset acts identically 
to init. 
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longname If the terminfo(4) data base is present and an entry for the user's 
terminal exists (see -Ttype above), then the long name of the 
terminal will be output. The long name is the last name in the 
first line of the terminal's description in the terminfo(4) data 
base [see term(5)]. 



EXAMPLES 

tput init 



FILES 



tput -T5620 reset 
tput cup 

tput clear 
tput cols 
tput -T450 cols 
bold='tput smso' 
offbold='tput rmso' 



Initialize the terminal according to the type of terminal 
in the environmental variable TERM. This command 
should be included in everyone's .profile after the 
environmental variable TERM has been exported, as 
illustrated on the profile{A) manual page. 

Reset an AT&T 5620 terminal, overriding the type of 
terminal in the environmental variable TERM. 

Send the sequence to move the cursor to row 0, column 
(the upper left corner of the screen, usually known as 
the "home" cursor position). 

Echo the clear-screen sequence for the current terminal. 
Print the number of columns for the current terminal. 
Print the number of columns for the 450 terminal. 



tput he 
tput cup 23 4 
tput longname 



Set the shell variables bold to begin stand-out mode 
sequence, and offbold to end stand-out mode sequence, 
for the current terminal. This might be followed by a 
prompt: 

echo "${bold}Please type in your name: 
${offbold}\c" 

Set exit code to indicate if the current terminal is a hard- 
copy terminal. 

Send the sequence to move the cursor to row 23, 
column 4. 

Print the long name from the terminfo{^) data base for 
the type of terminal specified in the environmental vari- 
able TERM. 



/usr /lib /terminf o /? /* 
/usr /include/curses.h 
/usr /include/term.h 
/usr/lib/tabset/* 



compiled terminal description data base 
curses{3X) header file 
terminf 0(4:) header file 

tab settings for some terminals, in a format 
appropriate to be output to the terminal (escape 
sequences that set margins and tabs); for more 
information, see the "Tabs and Initialization" 
section of terminf o (4) 
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SEE ALSO 

stty (1), tabs (1). 

profile(4), terminfo(4) in the Programmefs Reference Manual 
Chapter 10 of the Programmer's Guide. 
EXIT CODES 

If capname is of type Boolean, a value of is set for TRUE and 1 for FALSE. 

If capname is of type string, a value of is set if the capname is defined for 
this terminal type (the value of capname is returned on standard output); a 
value of 1 is set if capname is not defined for this terminal type (a null value 
is returned on standard output). 

If capname is of type integer, a value of is always set, whether or not cap- 
name is defined for this terminal type. To determine if capname is defined 
for this terminal type, the user must test the value of standard output. A 
value of -1 means that capname is not defined for this terminal type. 

Any other exit code indicates an error; see DIAGNOSTICS, below. 

DIAGNOSTICS 

tput prints the following error messages and sets the corresponding exit 
codes: 



exit 
code 



error message 







-1 (capname is a numeric variable that is not specified in the 

terminfo(4) data base for this terminal type, e.g., 

tput -T450 lines and tput -T2621 xmc) 

no error message is printed, see EXIT CODES above. 

usage error 

unknown terminal type or no terminfo(4i) data base 
unknown terminfo(^) capability capname 



1 
2 
3 
4 
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NAME 

tr - translate characters 

SYNOPSIS 

tr [ -cds ] [ stringl [ string2 ] ] 

DESCRIPTION 

The tr command copies the standard input to the standard output with sub- 
stitution or deletion of selected characters. Input characters found in stringl 
are mapped into the corresponding characters of stringl. Any combination 
of the options -cds may be used: 

-c Complements the set of characters in stringl with respect to the 

universe of characters whose ASCII codes are 001 through 377 
octal. 

-d Deletes all input characters in stringl . 

-s Squeezes all strings of repeated output characters that are in stringl 

to single characters. 
The following abbreviation conventions may be used to introduce ranges of 
characters or repeated characters into the strings: 

[a-z] Stands for the string of characters whose ASCII codes run from 
character a to character z, inclusive. 

[sL*n] Stands for n repetitions of a. If the first digit of n is 0, n is con- 
sidered octal; otherwise, n is taken to be decimal. A zero or miss- 
ing n is taken to be huge; this facility is useful for padding stringl . 

The escape character \ may be used as in the shell to remove special mean- 
ing from any character in a string. In addition, \ followed by 1, 2, or 3 
octal digits stands for the character whose ASCII code is given by those 
digits. 
EXAMPLE 

The following example creates a list of all the words in filel one per Ime m 
filel, where a word is taken to be a maximal string of alphabetics. The 
strings are quoted to protect the special characters from interpretation by the 
shell; 012 is the ASCII code for new-line. 

tr -cs "[A-Z][a-z]" "[\012*]" <filel >file2 

SEE ALSO 

ed(l), sh(l). 

ascii(5) in the Programmer's Reference Manual. 

BUGS 

Will not handle ASCII NUL in stringl or stringl; always deletes NUL from 
input. 
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NAME 

true, false ~ provide trnth values 

SYNOPSIS 
true 

false 

DESCRIPTION 

true does nothing, successfully. False does nothing, unsuccessfully. They 
are typically used in input to sh(l) such as: 

while true 
do 

command 

done 

SEE ALSO 

sh(l). 

DIAGNOSTICS 

true has exit status zero, false nonzero. 
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NAME 

tset - provide information to set terminal modes 

SYNOPSIS 

tset [ options ] [ type ] 

DESCRIPTION 

tset allows the user to set a terminal's ERASE and KILL characters, and define 
the terminal's type and capabilities by creating values for the TERM environ- 
ment variable, tset initializes or resets the terminal with tput(l). If a type is 
given with the -s option, tset creates information for a terminal of the speci- 
fied type. The type may be any type given in the terminfo database. If the 
type is not specified with the -s option, tset creates information for a termi- 
nal of the type defined by the value of the environment variable, TERM, 
unless the -h or -m option is given. If the TERM variable is defined, tset 
uses the terminfo database entry. If these options are used, tset searches the 
/etc/ttytype file for the terminal type corresponding to the current serial 
port; it then creates information for a terminal based on this type. If the 
serial port is not found in /etc/ttytype, the terminal type is set to 
unknown. 

tset displays the created information at the standard output. The informa- 
tion is in a form that can be used to set the current environment variables. 
The exact form depends on the login shell from which tset was invoked. 
The following examples illustrate how to use this information to change the 
variables. 

There are the following options: 

-e[c] Sets the ERASE character to c on all terminals. The default setting is 
the BACKSPACE, or CTRL-H. 

-E[c] Identical to the -e command except that it only operates on termi- 
nals that can BACKSPACE. 

-k[c] Sets the KILL character to c, defaulting to CTRL-U. 

Prints the terminal type on the standard output. 

-s Outputs the "setenv" commands [for csh{l)], or "export" and 
assignment commands [for sh{l)]. The type of commands are deter- 
mined by the user's login shell. 

-h Forces tset to search /etc/ttytype for information and to overlook 
the environment variable, TERM. 

-S Only outputs the strings to be placed in the environment variables, 
without the shell commands printed for -S. 

-r Prints the terminal type on the diagnostic output. 

-Q Suppresses the printing of the "Erase set to" and "Kill set to" mes- 
sages. 

-I Suppresses printing of the terminal initialization strings, e.g., 
spawns tput reset instead of tput init. 
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-m[ident][test baudrate]:type 

Allows a user to specify how a given serial port is is to be mapped 
to an actual terminal type. The option applies to any serial port in 
/etc/ttytype whose type is indeterminate (e.g., dialup, plugboard, 
etc.). The type specifies the terminal type to be used, and ident 
identifies the name of the indeterminate type to be matched. If no 
ident is given, all indeterminate types are matched. The 
test baudrate defines a test to be performed on the serial port before 
the type is assigned. The baudrate must be as defined in stty{l). 
The test may be any combination of: >, =, <, @, and !. If the 
type begins with a question mark, the user is asked if he really 
wants that type. A null response means to use that type; otherwise, 
another type can be entered which will be used instead. The ques- 
tion marie must be escaped to prevent filename expansion by the 
shell. If more than one -m option is given, the first correct map- 
ping prevails. 

tset is most useful when included in the .login [for csh(l)] or .profile [for 
sh{l)] file executed automatically at login, with -m mapping used to specify 
the terminal type you most frequently dial in on. 

EXAMPLES 

tset gt42 

tset -mdialup\>300:adm3a -mdialup:dw2 -Qr -e# 

tset -m dial:ti733 -m plug:\?hp2621 -m unknown:\? -e -k U 

To use the information created by the -s option for the Bourne shell, (sh), 
repeat these commands: 

tset -s ... > /tmp/tset$$ 

/tmp/tset$$ 

rm /tmp/tset$$ 

To use the information created for cs/z, use: 

set noglob 

set term=('tset -S ....') 
setenv TERM $term[l] 
unset term 
unset noglob 

FILES 

/etc/ttytype Port name to terminal type map database 

/usr/lib/terminfo/* Terminal capability database 

SEE ALSO 

stty(l), termio(7), tput(l), tty(l). 

terminfo(4) in the Programmer's Reference Manual. 

NOTES 

This utility was developed at the University of California at Berkeley and is 
used with permission. 
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NAME 

tty - get the name of the terminal 

SYNOPSIS 

tty [ -1 ] [ -s ] 

DESCRIPTION 

The tty command prints the path name of the user's terminal. 

-1 prints the synchronous line number to which the user's terminal is 
connected, if it is on an active synchronous line. 

-s inhibits printing of the terminal path name, allowing one to test just 
the exit code. 

EXIT CODES 
2 if invalid options were specified, 

if standard input is a terminal, 

1 otherwise. 

DIAGNOSTICS 

"not on an active synchronous line" if the standard input is not a synchro- 
nous terminal and -1 is specified. 

"not a tty" if the standard input is not a terminal and -s is not specified. 
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NAME 

uadmin - administrative control 

SYNOPSIS 

/etc/uadmin cmd fen 

DESCRIPTION 

The uadmin command provides control for basic administrative functions. 
This command is tightly coupled to the System Administration procedures 
and is not intended for general use. It may be invoked only by the super- 
user. 

The arguments cmd (command) and fen (function) are converted to integers 
and passed to the uadmin system call. 

SEE ALSO 

uadmin(2) in the Programmer's Reference Manual. 
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NAME 

umask - set file-creation mode mask 

SYNOPSIS 

umask [ ooo ] 

DESCRIPTION 

The user file-creation mode mask is set to ooo. The three octal digits refer 
to read/write/execute permissions for owner, group, and others, respectively 
[see chmod{2) and umask{2)]. The value of each specified digit is subtracted 
from the corresponding "digit" specified by the system for the creation of a 
file [see creat(2)]. For example, umask 022 removes group and others write 
permission (files normally created with mode 777 become mode 755; files 
created with mode 666 become mode 644). 

If 000 is omitted, the current value of the mask is printed. 

The umask command is recognized and executed by the shell. 

The umask command can be included in the user's .profile [see profile(4)] 
and invoked at login to automatically set the user's permissions on files or 
directories created. 

SEE ALSO 

chmod(l), sh(l). 

chmod(2), creat(2), umask(2), profile(4) in the Programmer's Reference 
Manual 
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NAME 

unadv - unadvertise a Remote File Sharing resource 

SYNOPSIS 

unadv resource 

DESCRIPTION 

The unadv command unadvertises a Remote File Sharing resource, which is 
the advertised symbolic name of a local directory, by removing it from the 
advertised information on the domain name server, unadv prevents subse- 
quent remote mounts of that resource. It does not affect continued access 
through existing remote or local mounts. 

An administrator at a server can unadvertise only those resources that phy- 
sically reside on the local machine. A domain administrator can unadvertise 
any resource in the domain from the primary name server by specifying 
resource name as domain.resource. (A domain administrator should only 
unadvertise another host's resources to clean up the domain advertise table 
when that host goes down. Unadvertising another host's resource changes 
the domain advertise table, but not the host advertise table.) 

This command is restricted to the super-user. 

ERRORS 

If resource is not found in the advertised information, an error message will 
be sent to standard error. 

SEE ALSO 

adv(lM), fumount(lM), nsquery(lM). 
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NAME 

uname - print name of current UNIX system 

SYNOPSIS 

uname [ -snrvma ] 
uname [ -S system name ] 

DESCRIPTION 

The uname command prints the current system name of the UNIX system on 
the standard output file. It is mainly useful to determine which system one 
is using. The options cause selected information returned by uname{l) to be 
printed: 

-s print system name (default). 

-n print nodename (the nodename is the name by which the system is 
known to a communications network). 

-r print the operating system release. 

-V print the operating system version. 

-m print the machine hardware name. 

-a print all the above information. 

On your computer, the system name and the nodename may be changed by 
specifying a system name argument to the -S option. The system name argu- 
ment is restricted to 8 characters. Only the super-user is allowed this capa- 
bility. 
SEE ALSO 

uname(2) in the Programmer's Reference Manual. 
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NAME 

uniq - report repeated lines in a file 
SYNOPSIS 

uniq [ -udc [ +n ] [ -n ] ] [ input [ output ] ] 
DESCRIPTION 

The uniq command reads the input file comparing adjacent lines. In the 
normal case, the second and succeeding copies of repeated lines are 
removed; the remainder is written on the output file. Input and output 
should always be different. Note that repeated lines must be adjacent in 
order to be found; see sort{l). If the -u flag is used, just the lines that are 
not repeated in the original file are output. The -d option specifies that one 
copy of just the repeated lines is to be written. The normal mode output is 
the union of the -u and -d mode outputs. 

The -c option supersedes -u and -d and generates an output report in 
default style but with each line preceded by a count of the number of times 
it occurred. 

The n arguments specify skipping an initial portion of each line in the com- 
parison: 

-n The first n fields together with any blanks before each are ignored. 

A field is defined as a string of non-space, non-tab characters 
separated by tabs and spaces from its neighbors. 

+n The first n characters are ignored. Fields are skipped before char- 
acters. 

SEE ALSO 

comm(l), sort(l). 



- 1 - 



UNITS(l) 



(Base System) 



UNITS(l) 



NAME 

units - conversion program 

SYNOPSIS 

units 

DESCRIPTION 

The units command converts quantities expressed in various standard scales 
to their equivalents in other scales. It works interactively in this fashion: 

You have: inch 
You want: cm 

* 2.540000e-h00 
/ 3.937008e-01 

A quantity is specified as a multiplicative combination of units optionally 
preceded by a numeric multiplier. Powers are indicated by suffixed positive 
integers, division by the usual sign: 

You have: 15 lbs force/in2 
You want: atm 

* 1.020689e+00 
/ 9.797299e-01 

The units command does only multiplicative scale changes; thus it can con- 
vert Kelvin to Rankine, but not Celsius to Fahrenheit. Most familiar units, 
abbreviations, and metric prefixes are recognized, together with a generous 
leavening of exotica and a few constants of nature including: 

pi ratio of circumference to diameter, 

c speed of light, 

e charge on an electron, 

g acceleration of gravity, 

force same as g, 

mole Avogadro's number, 

water pressure head per unit height of water, 

au astronomical unit. 

Pound is not recognized as a unit of mass; lb is. Compound names are run 
together, (e.g., lightyear). British units that differ from their U.S. counter- 
parts are prefixed thus: brgallon. For a complete list of units, type: 

cat /usr/lib/unittab 

FILES 

/usr/lib/unittab 
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NAME 

uucheck - check the uucp directories and permissions file 
SYNOPSIS 

/usr/lib/uucp/uucheck [ -v ] [ -x debug_level ] 
DESCRIPTION 

The uucheck command checks for the presence of the uucp system required 
files and directories. Within the uucp makefile, it is executed before the ins- 
tallation takes place. It also checks for some obvious errors in the Permis- 
sions file (/usr/lib/uucp/Permissions). When executed with the -v 
option, it gives a detailed explanation of how the uucp programs will inter- 
pret the Permissions file. The -x option is used for debugging. debugJievel 
is a single digit in the range 1-9; the higher the value, the greater the detail. 
Note that uucheck can only be used by the super-user or uucp. 

FILES 

/usr/lib/uucp /Systems 
/usr/lib /uucp /Permissions 
/usr/lib /uucp /Devices 
/usr/lib/uucp/Maxuuscheds 
/usr/lib /uucp/Maxuuxqts 
/usr/spool /uucp/* 
/usr/spool/locks /LCK* 
/usr/spool/uucppublic/* 

SEE ALSO 

uucico(lM), uucp(lC), uusched(lM), uustat(lC), uux(lC). 

BUGS 

The program does not check file/directory modes or some errors in the Per- 
missions file such as duplicate login or machine name. 
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NAME 

uucico - file transport program for the uucp system 
SYNOPSIS 

/usr/lib/uucp/uucico [ -r role-number ] [ -x debug-level ] 
[ -i interface ] [ -d spool-directory ] -s system— name 

DESCRIPTION 

uucico is the file transport program for uucp work file transfers. Role 
numbers for the -r are the digit 1 for master mode or for slave mode 
(default). The -r option should be specified as the digit 1 for master mode 
when uucico is started by a program or cron. Uux and uucp both queue jobs 
that will be transferred by uucico. It is normally started by the scheduler, 
uuschedfl, but can be started manually; this is done for debugging. For exam- 
ple, the shell Uutry starts uucico with debugging turned on. A single digit 
must be used for the -x option with higher numbers for more debugging. 
The -i option defines the interface used with uucico. This interface only 
affects slave mode. Known interfaces are UNIX (default), TLI (basic Tran- 
sport Layer Interface), and TLIS (Transport Layer Interface with Streams 
modules, read/ write). 

The -d option is used to specify the directory {spool— directory) that contains 
the work files to be transferred. The default spool directory is 
/usr/spool/uucp. The -s option defines the system (system-name) that 
uucico will try to contact. The system-name must be defined in the Systems 
file. 

FILES 

/usr /lib /uucp /Systems 
/usr /lib /uucp /Permissions 
/usr /lib /uucp /Devices 
/usr /lib /uucp /Devconfig 
/usr /lib /uucp /Sysfiles 
/usr /lib /uucp /Maxuuxqts 
/usr /lib /uucp/Maxuuscheds 
/usr /spool /uucp/* 
/usr/spool/locks/LCK* 
/usr /spool /uucppublic/* 

SEE ALSO 

uucp(lC), uustat(lC), uux(lC), cron(lM), Uutry(lM), uusched(lM). 
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NAME 

uucleanup - uucp spool directory clean-up 
SYNOPSIS 

/usr/lib/uucp/uucleanup [-C time] [-W time] [-X time] [-m string] 
[-0 time] [-S system] 

DESCRIPTION 

The uucleanup command will scan the spool directories for old files and 
take appropriate action to remove them in a useful way: 

Inform the requestor of send/receive requests for systems that cannot be 
reached. 

Return mail, which cannot be delivered, to the sender. 

Delete or execute rnews for rnews type files (depending on where the news 
originated — locally or remotely). 

Remove all other files. 

In addition, there is provision to warn users of requests that have been 
waiting for a given number of days (default 1). Note that uucleanup will 
process as if all option times were specified to the default values unless time 
is specifically set. 

The following options are available. 

-Ctime Any C. files greater or equal to time days old will be removed 
with appropriate information to the requestor, (default 7 days) 

-Dtime Any D. files greater or equal to time days old will be removed. 

An attempt will be made to deliver mail messages and execute 
rnews when appropriate, (default 7 days) 

-Wtime Any C. files equal to time days old will cause a mail message to 
be sent to the requestor warning about the delay in contacting 
the remote. The message includes the JOBID, and in the case of 
mail, the mail message. The administrator may include a mes- 
sage line telling whom to call to check the problem (-m option) 
(default 1 day) v ^ /• 

-Xtime Any X. files greater or equal to time days old will be removed. 

The D. files are probably not present (if they were, the X. could 
get executed). But if there are D. files, they will be taken care of 
by D. processing, (default 2 days) 

-mstring This line will be included in the warning message generated by 
the -W option. 

-otime Other files whose age is more than time days will be deleted. 

(default 2 days) The default line is "See your local administrator 
to locate the problem. " 

-ssystem Execute for system spool directory only. 
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"Xdebug— level 

The -X debug level is a single digit between and 9; higher 
numbers give more detailed debugging information. (If uucleanup 
was compiled with -DSMALL, no debugging output will be avail- 
able.) 

This program is typically started by the shell uudemon, cleanup, which 
should be started by cron(lM). 

FILES 

/usr/lib/uucp directory with commands used by uucleanup inter- 

nally 

/usr/spool/uucp spool directory 

SEE ALSO 

cron(lM), uucp(lC), uux(lC). 
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NAME 

uucp, uulog, uuname - UNIX-to-UNIX system copy 
SYNOPSIS 

uucp [ options ] source-files destination-file 
uulog [ options ] -s system 
uulog [ options ] system 
uulog [ options ] -fsystem 
uuname [ -1 ] [ -c ] 

DESCRIPTION 
uucp 

uucp copies files named by the source-files argument to the destination-file 
argument. A file name may be a path name on your machine, or may have 
the form: 

system-name!path-name 

where system-name is taken from a list of system names that uucp knows 
about. The system-name may also be a list of names such as 

system-namelsy stem-name! . . . !system-name!path-name 

in which case an attempt is made to send the file via the specified route, to 
the destination. See WARNINGS and BUGS below for restrictions. Care 
should be taken to ensure that intermediate nodes in the route are willing to 
forward information (see WARNINGS below for restrictions). 

The following shell metacharacters are disallowed in system-name: 

• ; & I < > ( ) <CR> <TAB> <SPACE> 

Path names may be one of: 

(1) a full path name. 

(2) a path name preceded by "user where user is a login name on 
the specified system and is replaced by that user's login direc- 
tory. 

(3) a path name preceded by "/destination where destination is 
appended to /usr/spool/uucppublic; [NOTE: This destina- 
tion will be treated as a file name unless more than one file is 
being transferred by this request or the destination is already a 
directory. To ensure that it is a directory, follow the destina- 
tion with a 7'. For example "/dstn/ as the destination will 
make the directory /usr/spool/uucppublic/dan if it does not 
exist and put the requested file(s) in that directory].** 

(4) anything else is prefixed by the current directory. 

If the result is an erroneous path name for the remote system, the copy will 
fail. If the destination-file is a directory, the last part of the source-file name 
is used. 
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uucp preserves execute permissions across the transmission and gives 0666 
read and write permissions [see chmod(2)]. 
The follov^ing options are interpreted by uucp: 

-c Do not copy local file to the spool directory for transfer to the 

remote machine (default). 
-C Force the copy of local files to the spool directory for transfer, 

-d Make all necessary directories for the file copy (default), 

-f Do not make intermediate directories for the file copy. 

'ggrade Grade is a single letter/number; lower ascii sequence characters 
will cause the job to be transmitted earlier during a particular 
conversation. 

-j Output the job identification ASCII string on the standard output. 

This job identification can be used by uustat to obtain the status 

or terminate a job. 
-m Send mail to the requester when the copy is completed. 

-nuser Notify user on the remote system that a file was sent, 
-r Do not start the file transfer, just queue the job. 

-sfile Report status of the transfer to file. Note that the file must be a 

full path name. 

-xdehugJievel 

Produce debugging output on standard output. The debug— level 
is a number between and 9; higher numbers give more detailed 
information. 

uulog 

uulog queries a log file of uucp or uuxqt transactions in a file 
/usr /spool /uucp /.Log/uvLcico/ system, 
or 

/usr/spool/uucp/.Log/uuxqt/si/stem. 

The options cause uulog to print logging information: 

-ssys Print information about file transfer work involving system sys. 

-isystem Does a "tail -f " of the file transfer log for system, (You must hit 
BREAK to exit this function.) Other options used in conjunction 
with the above: 

-X Look in the uuxqt log file for the given system. 

-number Indicates that a "tail" command of number lines should be exe- 
cuted. 

uuname 

uuname lists the names of systems known to uucp. The -c option returns 
the names of systems known to cu. (The two lists are the same, unless your 
machine is using different Systems files for cu and uucp. See the Sysfiles 
file.) The -1 option returns the local system name. 
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FILES 

/usr/spool/uucp spool directories 

/usr/spool/uucppublic/* public directory for receiving and 

sending (/usr/spool/uuqppublic) 
/usr/lib/uucp/* other data and program files 

SEE ALSO 

mail(l), uustat(lC), Uutry(lM), uux(lC), uuxqt(lM). 
chmod(2) in the Programmer's Reference Manual. 
WARNINGS 

The domain of remotely accessible files can (and for obvious security rea- 
sons, usually should) be severely restricted. You will very likely not be able 
to fetch files by path name; ask a responsible person on the remote system 
to send them to you. For the same reasons, you will probably not be able 
to send files to arbitrary path names. As distributed, the remotely accessible 
files are those whose names begin /usr/spool/uucppublic (equivalent to 

All files received by uucp will be owned by uucp. 

The -m option will only work sending files or receiving a single file. 
Receiving multiple files specified by special shell characters ? * [...] will 
not activate the -m option. 

The forwarding of files through other systems may not be compatible with 
the previous version of uucp. If forwarding is used, all systems in the route 
must have the same version of uucp. 

BUGS 

Protected files and files that are in protected directories that are owned by 
the requester can be sent by uucp using the -C option. However, if the 
requestor is root, and the directory is not searchable by "other" or the file 
is not readable by "other", the request will fail. 
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NAME 

uugetty - set terminal type, modes, speed, and line discipline 
SYNOPSIS 

/usr/lib/uucp/uugetty [-t timeout] [-r] line [speed [type [linedisc] ] ] 
/usr/lib/uucp/uugetty -c file 

DESCRIPTION 

uugetty is a standard getty{lM) modified to allow a tty line to be used by 
uucico, cu, and ct; that is, the line can be used in both directions. The 
uugetty will allow users to login, but if the line is free, uucico, cu, or ct can 
use it for dialing out. The implementation depends on the fact that uucico, 
cu, and ct create lock files when devices are used. When the "openQ" 
returns (or the first character is read when -r option is used), the status of 
the lock file indicates whether the line is being used by uucico, cu, ct, or 
someone trying to login. Note that in the -r case, several <carriage-return> 
characters may be required before the login message is output. The human 
users will be able to handle this slight inconvenience, uucico trying to login 
will have to be told by using the following login script: 

" " \r\d\r\d\r\d\r in:-in: . . . 

where the . . . is whatever would normally be used for the login sequence. 

If there is a uugetty on one end of a direct line, there must be a uugetty on 
the other end as well. Here is an /etc/inittab entry using uugetty on an 
intelligent modem or direct line: 

30:2:respawn:/usr/lib/uucp/uugetty -r -t 60 ttyOO 1200 

The meanings of the available options are: 
-t timeout 

Specifies that uugetty should exit if the open on the line succeeds 
and there is no response to the login prompt in timeout seconds. 
timeout is replaced by an integer. 

-r Causes uugetty to wait to read a character before it puts out the 
login message, thus preventing two uugettys from looping. An 
entry for an intelligent modem or direct line that has a uugetty on 
each end must use this option. 

line Defines the name of the line to which uugetty will attach itself. The 
line name will point to an entry in the /dev directory. For example, 
/dev/ttyOO. 

speed Defines the entry to use from the /etc/gettydefs file. The entry 
defines the line speed, the login message, the initial tty setting, and 
the next speed to try if the user says the speed is inappropriate (by 
sending a break character). The default speed is 300. 

type Defines the type of terminal connected to the line. The default ter- 
minal is none, representing a normal terminal unknown to the sys- 
tem. 
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linedisc Sets the line discipline to use on the line. The default is LDISCO, 
which is the only one currently compiled into the operating system. 

-c file Checks the speed and tty definitions in file and sends the results to 
standard output. Unrecognized modes and improperly constructed 
entries are reported. For correct entries, flag values are printed, file 
is replaced by /etc/gettydefs or a similarly structured file. 

FILES 

/etc/gettydefs 
/etc/issue 

SEE ALSO 

login(l), ct(lC), cu(lC), getty(lM), init(lM), uucico(lM), tty(7). 
ioctl(2), gettydefs(4), inittab(4) in the Programmer's Reference Manual. 

BUGS 

ct will not work when uugetty is used with an intelligent modem such as 
penril or ventel. 
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NAME 

uusched - the scheduler for the uucp file transport program 
SYNOPSIS 

/usr/lib/uucp/uusched [ -x debug—level ] [ -u debug—level ] 
DESCRIPTION 

The uusched command is the uucp file transport scheduler. It is usually 
started by the daemon uudemon.hour that is started by cron(lM) from an 
entry in /usr/spool/cron/crontab: 

39 * * * * /bin/su uucp -c "/usr/lib/uucp/uudemon.hour > /dev/null" 

The two options are for debugging purposes only; -x debug—level will out- 
put debugging messages from uusched and -u debug—level will be passed as 
-X debug— level to uucico. The debug— level is a number between and 9; 
higher numbers give more detailed information. 

FILES 

/usr /lib /uucp /Systems 
/usr /lib /uucp /Permissions 
/usr /lib /uucp /Devices 
/usr/spool/uucp/* 
/usr/spool /locks /LCK* 
/usr /spool /uucppublic/* 

SEE ALSO 

cron(lM), uucico(lM), uucp(lC), uustat(lC), uux(lC). 
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NAME 

uustat - uucp status inquiry and job control 

SYNOPSIS 

uustat [-a] 

uustat [-m] 

uustat [-p] 

uustat [-q] 

uustat [ -kjobid ] 

uustat [ -rjobid ] 

uustat [ -s system ] [ -uuser ] 

DESCRIPTION 

The uustat command will display the status of, or cancel, previously speci- 
fied uucp commands, or provide general status on uucp connections to other 
systems. Only one of the following options can be specified with uustat per 
command execution: 

-a Output all jobs in queue. 

-m Report the status of accessibility of all machines. 

-p Execute a "ps -flp" for all the process-ids that are in the lock 

files. 

-q List the jobs queued for each machine. If a status file exists for 

the machine, its date, time and status information are reported. 
In addition, if a number appears in () next to the number of C or 
X files, it is the age in days of the oldest C./X. file for that sys- 
tem. The Retry field represents the number of hours until the 
next possible call. The Count is the number of failure attempts. 
NOTE: For systems with a moderate number of outstanding 
jobs, this could take 30 seconds or more of real-time to execute. 
As an example of the output produced by the -q option: 

eagle 3C 04/07-11:07 NO DEVICES AVAILABLE 

mh3bs3 2C 07/07-10:42 SUCCESSFUL 

The above output tells how many command files are waiting for 
each system. Each command file may have zero or more files to 
be sent (zero means to call the system and see if work is to be 
done). The date and time refer to the previous interaction with 
the system followed by the status of the interaction. 

-kjobid Kill the uucp request whose job identification is jobid. The killed 
uucp request must belong to the person issuing the uustat com- 
mand unless one is the super-user. 

-rjobid Rejuvenate jobid . The files associated with jobid are touched so 
that their modification time is set to the current time. This 
prevents the cleanup daemon from deleting the job until the jobs 
modification time reaches the limit imposed by the daemon. 
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FILES 



Either or both of the following options can be specified with uustat: 

-ssys Report the status of all uucp requests for remote system sys. 

-uuser Report the status of all uucp requests issued by user. 

Output for both the -s and -u options has the following format: 

eaglenOOOO 4/07-11:01:03 (POLL) 

eagleNlbdZ 4/07-11:07 Seagledan522 /usr/dan/A 

eagleClbdS 4/07-11:07 Seagledan59 D.3b2al2ce4924 

4/07-11:07 Seagledanrmail mike 

With the above two options, the first field is the job id of the job. This is fol- 
lowed by the date/time. The next field is either an 'S' or 'R' depending on 
whether the job is to send or request a file. This is followed by the user-id 
of the user who queued the job. The next field contains the size of the file, 
or in the case of a remote execution ( rmail - the command used for remote 
mail), the name of the command. When the size appears in this field, the 
file name is also given. This can either be the name given by the user or an 
internal name (e.g., D.3b2alce4924) that is created for data files associated 
with remote executions (rmail in this example). 

When no options are given, uustat outputs the status of all uucp requests 
issued by the current user. 



/usr/spool/uucp/* spool directories 

SEE ALSO 

uucp(lC). 
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NAME 

uuto, uupick - public UNIX system to UNIX system file copy 
SYNOPSIS 

uuto [ options ] source-files destination 
uupick [ -s system ] 

DESCRIPTION 

The uuto command sends source-files to destination, uuto uses the uucp{lC) 
facility to send files, while it allows the local system to control the file 
access. A source-file name is a path name on your machine. Destination 
has the form: 

systemluser 

where system is taken from a list of system names that uucp knows about 
(see uuname). User is the login name of someone on the specified system. 

Two options are available: 

-p Copy the source file into the spool directory before transmission, 
-m Send mail to the sender when the copy is complete. 

The files (or sub-trees if directories are specified) are sent to PUBDIR on sys- 
tern, where PUBDIR is a public directory defined in the uucp source. By 
default this directory is /usr/spool/uucppublic. Specifically the files are 
sent to 

PUBDIR /receive /user /my system /files. 

The destined recipient is notified by mail(l) of the arrival of files. 

The uupick command accepts or rejects the files transmitted to the user. 
Specifically, uupick searches PUBDIR for files destined for the user. For each 
entry (file or directory) found, the following message is printed on the stan- 
dard output: 

from system: [file file-name] [dir dirname] ? 

The uupick command then reads a line from the standard input to deter- 
mine the disposition of the file: 

<new-line> Go on to next entry. 

d Delete the entry. 

m [ dir ] Move the entry to named directory dir. If dir is not speci- 

fied as a complete path name (in which $HOME is legiti- 
mate), a destination relative to the current directory is 
assumed. If no destination is given, the default is the 
current directory. 

a [ dir ] Same as m except moving all the files sent from system . 

p Print the content of the file, 

q Stop. 
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EOT (control-d) Same as q. 

{command Escape to the shell to do command. 

* Print a command summary. 

The unpick command invoked with the -ssystem option will only search the 
PUBDIR for files sent from system . 

FILES 

PUBDIR /usr/spool/uucppublic public directory 
SEE ALSO 

mail(l), uucleanup(lM), uucp(lC), uustat(lC), uux(lC). 
WARNINGS 

In order to send files that begin with a dot (e.g., .profile), the files must be 
qualified with a dot. For example: .profile, .prof*, .profil? are correct; 
whereas *prof*, ?profile are incorrect. 
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NAME 

uux - UNIX system to UNIX system command execution 

SYNOPSIS 

uux [ options ] command-string 

DESCRIPTION 

The uux command will gather zero or more files from various systems, exe- 
cute a command on a specified system, and then send standard output to a 
file on a specified system. 

NOTE: For security reasons, most installations limit the list of commands 
executable on behalf of an incoming request from uux, permitting only the 
receipt of mail [see mail{l)]. (Remote execution permissions are defined in 
/usr/lib /uucp /Permissions.) 

The command-string is made up of one or more arguments that look like a 
shell command line, except that the command and file names may be pre- 
fixed by system-namel A null system-name is interpreted as the local system. 

File names may be one of: 

(1) a full path name; 

(2) a path name preceded by "xxx where xxx is a login name on 
the specified system and is replaced by that user's login direc- 
tory; 

(3) anything else is prefixed by the current directory. 

As an example, the command 

uux "Idiff usg!/usr/dan/filel pwba!/a4/dan/file2 > 
r/dan/file.diff" 

will get the filel and jfile2 files from the ''usg" and "pwba" machines, exe- 
cute a diff(l) command, and put the results in file.diff in the local 
PUBDIR/dan/ directory. 

Any special shell characters such as <>;| should be quoted either by quot- 
ing the entire command-string, or quoting the special characters as individual 
arguments. 

The uux command will attempt to get all files to the execution system. For 
files that are output files, the file name must be escaped using parentheses. 
For example, the command 

uux a!cut -fl b!/usr/file \(c!/usr/file\) 

gets /usr/file from system "b" and sends it to system "a", performs a cut 
command on that file, and sends the result of the cut command to system 

II Q II 

The uux command will notify you if the requested command on the remote 
system was disallowed. This notification can be turned off by the -n 
option. The response comes by remote mail from the remote machine. 
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The following options are interpreted by uux: 

The standard input to uux is made the standard input to the 
command'String . 

-mame Use name as the user identification replacing the initiator user-id. 
(Notification will be returned to the user.) 

-b Return whatever standard input was provided to the uux com- 

mand if the exit status is non-zero. 

-c Do not copy local file to the spool directory for transfer to the 

remote machine (default). 

-C Force the copy of local files to the spool directory for transfer. 

-ggrade Grade is a single letter/number; lower ASCII sequence characters 
will cause the job to be transmitted earlier during a particular 
conversation. 

-j Output the jobid ASCII string on the standard output, which is 

the job identification. This job identification can be used by uus- 
tat to obtain the status or terminate a job. 

-n Do not notify the user if the command fails. 

-p Same as -: The standard input to uux is made the standard 

input to the command-string. 

-r Do not start the file transfer, just queue the job. 

-sfile Report status of the transfer in file. 

-xdehug— level 

Produce debugging output on the standard output. The 
debug— level is a number between and 9; higher numbers give 
more detailed information. 

-z Send success notification to the user. 

/usr/lib/uucp/spool spool directories 

/usr/lib/uucp/Permissions remote execution permissions 
/usr/lib/uucp/* other data and programs 

SEE ALSO 

cut(l), mail(l), uucp(lC), uustat(lC). 

WARNINGS 

Only the first command of a shell pipeline may have a system-namel. All 
other commands are executed on the system of the first command. 
The use of the shell metacharacter * will probably not do what you want it 
to do. The shell tokens « and » are not implemented. 

The execution of commands on remote systems takes place in an execution 
directory known to the uucp system. All files required for the execution will 
be put into this directory unless they already reside on that machine. 



FILES 
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Therefore, the simple file name (without path or machine reference) must be 
unique within the uux request. The following command will NOT work: 

uux "aldiff b!/usr/dan/xyz c!/usr/dan/xyz > Ixyz.diff" 

but the command 

uux "aidiff a!/usr/dan/xyz c!/usr/dan/xyz > Ixyz.diff" 

will work (if diff is a permitted command). 

BUGS 

Protected files and files that are in protected directories that are owned by 
the requester can be sent in commands using uux. However, if the reques- 
ter is root, and the directory is not searchable by "other", the request will 
fail. 
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NAME 

uuxqt - execute remote command requests 
SYNOPSIS 

/usr/lib/uucp/uuxqt [ -s system ] [ -x debug—level ] 
DESCRIPTION 

The uuxqt command executes remote job requests from remote systems gen- 
erated by the use of the uux command. (Mail uses uux for remote mail 
requests.) uuxqt searches the spool directories looking for X. files. For each 
X. file, uuxqt checks to see if all the required data files are available and 
accessible, and file commands are permitted for the requesting system. The 
Permissions file is used to validate file accessibility and command execution 
permission. 

There are two environment variables that are set before the uuxqt command 
is executed: 

UU_MACHINE is the machine that sent the job (the previous one). 
UU_USER is the user that sent the job. 

These can be used in writing commands that remote systems can execute to 
provide information, auditing, or restrictions. 

The -X debug— level is a single digit between and 9. Higher numbers give 
more detailed debugging information. 

FILES 

/usr /lib /uucp /Permissions 
/usr /lib /uucp /Maxuuxqts 
/usr/spool/uucp/* 
/usr /spool /locks /LCK* 

SEE ALSO 

mail(l), uucico(lM). uucp(lC), uustat(lC), uux(lC). 
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NAME 

vi, view, vedit - screen-oriented (visual) display editor based on ex 
SYNOPSIS 

vi [-t tag] [-r file] [-L] [-wn] [-R] [-x] [-C] [-c command] file . . . 
view [-t tag] [-r file] [-L] [-wn] [-R] [-x] [-C] [-c command] file . . . 
vedit [-t tag] [-r file] [-L] [-wn] [-R] [-x] [-C] [-c command] file . . . 

DESCRIPTION 

vi (visual) is a display-oriented text editor based on an underlying line edi- 
tor ex{l). It is possible to use the command mode of ex from within vi and 
vice- versa. The visual commands are described on this manual page; how 
to set options (like automatically numbering lines and automatically starting 
a new output line when you type carriage return) and all ex(l) line editor 
commands are described on the ex(l) manual page. 

When using vi, changes you make to the file are reflected in what you see 
on your terminal screen. The position of the cursor on the screen indicates 
the position within the file. 

Invocation Options 

The following invocation options are interpreted by vi (previously docu- 
mented options are discussed in the NOTES section at the end of this 
manual page): 

-t tag Edit the file containing the tag and position the editor at its 

definition. 

-r file Edit file after an editor or system crash, (Recovers the ver- 

sion of file that was in the buffer when the crash occurred.) 

-L List the name of all files saved as the result of an editor or 

system crash. 

-w« Set the default window size to n . This is useful when using 

the editor over a slow-speed line. 

-R Read-only mode; the read-only flag is set, preventing 

accidental overwriting of the file. 

-X Encryption option; when used, vi simulates the X command 

of ex(l) and prompts the user for a key. This key is used to 
encrypt and decrypt text using the algorithm of crypt(l). 
The X command makes an educated guess to determine 
whether text read in is encrypted or not. The temporary 
buffer file is encrypted also, using a transformed version of 
the key typed in for the -x option. [See crypt (1)]. Also, see 
the WARNING section at the end of this manual page. 

-C Encryption option; same as the -x option, except that vi 

simulates the C command of ex{l). The C command is like 
the X command of ex{l), except that all text read in is 
assumed to have been encrypted. 

-c command Begin editing by executing the specified editor command 
(usually a search or positioning command). 
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The file argument indicates one or more files to be edited. 

The view invocation is the same as vi except that the read-only flag is set. 

The vedit invocation is intended for beginners. It is the same as vi except 
that the report flag is set to 1, the showmode and novice flags are set, and 
magic is turned off. These defaults make it easier to learn how to use vi, 

vi Modes 

Command Normal and initial mode. Other modes return to command 
mode upon completion. ESC (escape) is used to cancel a 
partial command. 

Input Entered by setting any of the following options: a A i I o 

O c C s S R. Arbitrary text may then be entered. Input 
mode is normally terminated with ESC character, or, abnor- 
mally, with an interrupt. 

Last line Reading input for : / ? or !; terminate by typing a carriage 

return; an interrupt cancels termination. 

COMMAND SUMMARY 

In the descriptions, CR stands for carriage return and ESC stands for the 
escape key. 

Sample commands 



^ j t ^ arrow keys move the cursor 

h j k 1 same as arrow keys 

itextESC insert text 

cvfnewESC change word to new 

easESC pluralize word (end of word; append s; 

escape from input state) 

X delete a character 

dw delete a word 

dd delete a line 

3dd delete 3 lines 

u undo previous change 

ZZ exit vi, saving changes 

:q!CR quit, discarding changes 

/textCR search for text 

U D scroll up or down 

icmdCR any ex or ed command 



Counts before vi commands 

Numbers may be typed as a prefix to some commands. They are inter- 
preted in one of these ways, 
line/column number z I 

scroll amount D U 

repeat effect most of the rest 

Interrupting, canceling 

ESC end insert or incomplete cmd 

DEL (delete or rubout) interrupts 
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File msnipuldtion 




ZZ 


if file modified, write dnd exit; otherwise, exit 


• WV«Xx 




:w ! CR 


forfpH writp if DPrmiQQinn oHcyinallv nof valiH 

WlllC, 11 L^Cl 11 llOSll^l 1 V71 1X^11 IClllV llvrl V dllU. 


:qCR 


cjuit 


•fl»CR 

• iJ • V.XX 




•p finttipC^m. 


pHif flip ttntfip 




ICCUIL, Uisv.ctlU. (.ilctllgcro 




edit startiTip' at end 


:e +nCR 


edit starting at line ti 


:e #CR 


edit altprnatp file 

^wilL CtlL^lllvlL^ lllC 


:e! #CR 


edit alternate file, discard changes 


:w nameCR 


write file name 


:w! nameCR 


overwrite file name 


:shCR 


run shell, then return 


ilcmdCR 


run cmd, then return 


:nCR 


edit next file in arglist 


:n argsCR 


specify new arglist 


G 


show current file and line 


:ta tagCR 


position cursor to tag 



In general, any ex or ed command (such as substitute or global) may be 
typed, preceded by a colon and followed by a carriage return. 

Positioning within file 

F forward screen 

B backward screen 

D scroll down half screen 

U scroll up half screen 

nG go to the beginning of the specified line 

(end default), where w is a line number 

/pat next line matching pat 

Ipat previous line matching pat 

n repeat last / or ? command 

N reverse last / or ? command 

Ipat I -^n n-th line after pat 

Ipatl-n n-th line before pat 

]] next section/function 

[[ previous section/f unction 

( beginning of sentence 

) end of sentence 

{ beginning of paragraph 

} end of paragraph 

% find matching ( ) { or } 

Adjusting the screen 

L clear and redraw window 

R clear and redraw window if L is — »- key 

zCR redraw screen with current line at top of window 

z-CR redraw screen with current line at bottom of window 

z .CR redraw screen with current line at center of window 

/pat/z-CR move pat line to bottom of window 
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zn .CR use «-line window 

E scroll window down 1 line 

Y scroll window up 1 line 

Marking and returning 

move cursor to previous context 

" move cursor to first non-white space in line 

mx mark current position with the ASCII lower-case letter x 

'X move cursor to mark x 

'X move cursor to first non -white space in line marked by x 

Line positioning 

H top line on screen 

L last line on screen 

M middle line on screen 

-h next line, at first non-white 

previous line, at first non-white 

CR return, same as + 

i or j next line, same column 

t or k previous line, same column 

Character positioning 

first non white-space character 

beginning of line 
$ end of line 

h or — ► forward 

1 or backward 

*H same as ^ (backspace) 

space same as (space bar) 

ix find next x 

Fx find previous x 

\x move to character prior to next x 

Tx move to character following previous x 

; repeat last f F t or T 

, repeat inverse of last f F t or T 

nl move to column n 

% find matching ( { ) or } 

Words, sentences, paragraphs 

w forward a word 

b back a word 

e end of word 

) to next sentence 

} to next paragraph 

( back a sentence 

{ back a paragraph 

W forward a blank-delimited word 

B back a blank-delimited word 

E end of a blank-delimited word 
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Corrections during insert 

erase last character (backspace) 
W erase last word 

erase your erase character, same as H (backspace) 

kill your kill character, erase this line of input 

\ quotes your erase and kill characters 

ESC ends insertion, back to command mode 

DEL interrupt, terminates insert mode 

D backtab one character; reset left margin 

of autoindent 
D caret ( ) followed by control-d ( D); 

backtab to beginning of line; 

do not reset left margin of autoindent 

D backtab to beginning of line; 

reset left margin of autoindent 
V quote non-printable character 

Insert and replace 

a append after cursor 

A append at end of line 

1 insert before cursor 

I insert before first non-blank 

o open line below 

O open above 

rx replace single char with x 

RtextESC replace characters 

Operators 



Operators are followed by a cursor motion, and affect all text that would 
have been moved over. For example, since w moves over a word, dw 
deletes the word that would be moved over. Double the operator, e.g., dd 
to affect whole lines. 



d delete 

c change 

y yank lines to buffer 

< left shift 

> right shift 

! filter through command 

Miscellaneous Operations 

C change rest of line (c$) 

D delete rest of line (d$) 

s substitute chars (cl) 

S substitute lines (cc) 

J join lines 

X delete characters (dl) 

X delete characters before cursor (dh) 

Y yank lines (yy) 
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Yank and Put 

Put inserts the text most recently deleted or yanked; however, if a buffer is 
named (using the ASCII lower-case letters a - z), the text in that buffer is put 



instead. 

3yy yank 3 lines 

3yl yank 3 characters 

p put back text after cursor 

P put back text before cursor 

":q> put from buffer x 

" xy yank to buffer x 

" x& delete into buffer x 

Undo, Redo, Retrieve 

u undo last change 

U restore current line 
repeat last change 

" p retrieve (ith last delete 

AUTHOR 



vi and ex were developed by The University of California, Berkeley Califor- 
nia, Computer Science Division, Department of Electrical Engineering and 
Computer Science. 

FILES 

/tmp default directory where temporary work files are 

placed; it can be changed using the directory 
option (see the ex{l) set command) 
/usr/lib/terminfo/?/* compiled terminal description data base 
/usr/lib/.COREterm/?/* subset of compiled terminal description data base 

NOTES 

Two options, although they continue to be supported, have been replaced in 
the documentation by options that follow the Command Syntax Standard 
[see fnfro(l)]. A -r option that is not followed with an option-argument has 
been replaced by -L and -^command has been replaced by -c command. 

SEE ALSO 

ed(l), edit(l), ex(l). 

User's Guide. 

curses/terminfo chapter of the Programmer's Guide. 
WARNINGS 

The encryption options are provided with the Security Administration Utili- 
ties package, which is available only in the United States. 
Tampering with entries in /usr/lib/.COREterm/?/* or 
/usr/lib/terminfo/?/* (for example, changing or removing an entry) can 
affect programs such as vi(l) that expect the entry to be present and correct. 
In particular, removing the "dumb" terminal may cause unexpected prob- 
lems. 
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BUGS 

Software tabs using T work only immediately after the autoindent. 

Left and right shifts on intelligent terminals do not make use of insert and 
delete character operations in the terminal. 



VOLCOPY(IM) 



(Base System) 



VOLCOPY(IM) 



NAME 

volcopy - make literal copy of file system 
SYNOPSIS 

/etc/ volcopy [options] fsname srcdevice volnamel destdevice volname2 
DESCRIPTION 

The volcopy command makes a literal copy of the file system using a block- 
size matched to the device. Options are: 

-a invoke a verification sequence requiring a positive operator 

response instead of the standard 10-second delay before the 

copy is made 

-s (default) invoke the DEL if wrong verification sequence. 

The program requests length and density information if it is not given on 
the command line or is not recorded on an input tape label. If the file sys- 
tem is too large to fit on one reel, volcopy will prompt for additional reels. 
Labels of all reels are checked. Tapes may be mounted alternately on two 
or more drives. If volcopy is interrupted, it will ask if the user wants to quit 
or wants a shell. In the latter case, the user can perform other operations 
(e.g., labelit) and return to volcopy by exiting the new shell. 
The fsname argument represents the mounted name (e.g., root, ul, etc.) of 
the filsystem being copied. 

The srcdevice or destdevice should be the physical disk section or tape (e.g.: 
/dev/dsk/Osl etc.). 

The volname is the physical volume name (e.g.: pk3, t0122, etc.) and 
should match the external label sticker. Such label names are limited to six 
or fewer characters. Volname may be - to use the existing volume name. 

Srcdevice and volnamel are the device and volume from which the copy of 
the file system is being extracted. Destdevice and volnamel are the target 
device and volume. 

Fsname and volname are recorded in the last 12 characters of the super block 
(char fsname[6], volname[6];). 

FILES 

/etc/log/filesave.log a record of file systems/volumes copied 

SEE ALSO 

labelit(lM), sh(l). 

fs(4) in the Programmer's Reference Manual. 



- 1 - 



WAIT(l) 



(Base System) 



WAIT(l) 



NAME 

wait - await completion of process 

SYNOPSIS 

wait [ n ] 

DESCRIPTION 

Wait for your background process whose process id is n and report its ter- 
mination status. If n is omitted, all your shell's currently active background 
processes are waited for and the return code will be zero. 

The shell itself executes wait, without creating a new process. 

SEE ALSO 

sh(l). 

CAVEAT 

If you get the error message cannot fork, too many processes, try using the 
zvait(l) command to clean up your background processes. If this doesn't 
help, the system process table is probably full or you have too many active 
foreground processes. (There is a limit to the number of process ids associ- 
ated with your login and the number the system can keep track of.) 

BUGS 

Not all the processes of a 3- or more-stage pipeline are children of the shell, 
and thus cannot be waited for. 

If n is not an active process id, all your shell's currently active background 
processes are waited for and the return code will be zero. 
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NAME 

wall - write to all users 

SYNOPSIS 

/etc/wall 

DESCRIPTION 

The wall command reads its standard input until an end-of-file. It then 
sends this message to all currently logged-in users preceded by: 

Broadcast Message from . . . 

It is used to warn all users, typically prior to shutting down the system. 
The sender must be super-user to override any protections the users may 
have invoked [see mesg(l)]. 

FILES 

/dev/tty* 

SEE ALSO 

mesg(l), write(l). 

DIAGNOSTICS 

"Cannot send to ../' when the open on a user's tty file fails. 



- 1 - 



WC(1) 



(Base System) 



WC(1) 



NAME 

wc - word count 

SYNOPSIS 

wc [ -Iwc ] [ names ] 

DESCRIPTION 

The wc command counts lines, words, and characters in the named files, or 
in the standard input if no names appear. It also keeps a total count for all 
named files. A word is a maximal string of characters delimited by spaces, 
tabs, or new-lines. 

The options 1, w, and c may be used in any combination to specify that a 
subset of lines, words, and characters are to be reported. The default is 
-Iwc. 

When names are specified on the command line, they will be printed along 
with the counts. 
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NAME 

who - who is on the system 

SYNOPSIS 

who [-uTlHqpdbrtas] [ file ] 

who am i 

who am I 

DESCRIPTION 

The who command can list the user's name, terminal line, login time, 
elapsed time since activity occurred on the line, and the process-ID of the 
command interpreter (shell) for each current UNIX system user. It examines 
the /etc/utmp file at login time to obtain its information. If file is given, 
that file [which must be in utmp(A) format] is examined. Usually, file will be 
/etc/wtmp, which contains a history of all the logins since the file was last 
created. 

The who command with the am i or am I option identifies the invoking 
user. 

The general format for output is: 

name [state] line time [idle] [pid] [comment] [exit] 

The name, line, and time information is produced by all options except -q; 
the state information is produced only by -T; the idle and pid information is 
produced only by -u and -1; and the comment and exit information is pro- 
duced only by -a. The information produced for -p, -d, and -r is explained 
during the discussion of each option below. 

With options, who can list logins, logoffs, reboots, and changes to the sys- 
tem clock, as well as other processes spawned by the init process. These 
options are: 

-u This option lists only those users who are currently logged in. The 
name is the user's login name. The line is the name of the line as 
found in the directory /dev. The time is the time that the user 
logged in. The idle column contains the number of hours and 
minutes since activity last occurred on that particular line. A dot (.) 
indicates that the terminal has seen activity in the last minute and is 
therefore "current." If more than twenty-four hours have elapsed or 
the line has not been used since boot time, the entry is marked old. 
This field is useful when trying to determine whether a person is 
working at the terminal or not. The pid is the process-ID of the 
user's shell. The comment is the comment field associated with this 
line as found in /etc/inittab [see inittab[4]]. This can contain infor- 
mation about where the terminal is located, the telephone number of 
the dataset, type of terminal if hard-wired, etc. 

-T This option is the same as the -s option, except that the state of the 
terminal line is printed. The state describes whether someone else 
can write to that terminal. A + appears if the terminal is writable by 
anyone; a - appears if it is not. root can write to all lines having a -f 
or a - in the state field. If a bad line is encountered, a ? is printed. 
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-1 This option lists only those lines on which the system is waiting for 
someone to login. The name field is LOGIN in such cases. Other 
fields are the same as for user entries except that the state field does 
not exist. 

-H This option will print column headings above the regular output. 

-q This is a quick who, displaying only the names and the number of 
users currently logged on. When this option is used, all other options 
are ignored. 

-p This option lists any other process which is currently active and has 
been previously spawned by init. The name field is the name of the 
program executed by init as found in /etc/inittab. The state, line, 
and idle fields have no meaning. The comment field shows the id 
field of the line from /etc/inittab that spawned this process. See 
inittab(4), 

-d This option displays all processes that have expired and not been 
respawned by init. The exit field appears for dead processes and 
contains the termination and exit values [as returned by wait(2)] of 
the dead process. This can be useful in determining why a process 
terminated. 

-b This option indicates the time and date of the last reboot. 

-r This option indicates the current run-level of the init process. In 
addition, it produces the process termination status, process id, and 
process exit status [see utmp(4)] under the idle, pid, and comment 
headings, respectively. 

-t This option indicates the last change to the system clock [via the 
date{l) command] by root. See sm(1M). 

-a This option processes /etc/utmp or the named file with all options 
turned on. 

-s This option is the default and lists only the name, line, and time 
fields. 

Note to the super-user: After a shutdown to the single-user state, who 
returns a prompt; the reason is that since /etc/utmp is updated at login 
time and there is no login in single-user state, who cannot report accurately 
on this state, who am i, however, returns the correct information. 

FILES 

/etc/utmp 
/etc/wtmp 
/etc/inittab 

SEE ALSO 

date(l), init(lM), login(l), mesg(l), su(lM). 

wait(2), inittab(4), utmp(4) in the Programmer's Reference Manual. 
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NAME 

whodo - who is doing what 

SYNOPSIS 

/etc/ whodo 

DESCRIPTION 

The whodo command produces formatted and dated output from informa- 
tion in the /etc/utmp and /etc/ps_-data files. 

The display is headed by the date, time, and machine name. For each user 
logged in, device name, user-id, and login time is shown, followed by a list 
of active processes associated with the user-id. The list includes the device 
name, process-id, cpu minutes and seconds used, and process name. 

EXAMPLE 

The command: 



whodo 



produces a display like this: 



Tue Mar 12 15:48:03 1985 
bailey 

tty09 men 8:51 
tty09 28158 0:29 sh 

tty52 bdr 15:23 
tty52 21688 0:05 sh 
tty52 22788 0:01 whodo 
tty52 22017 0:03 vi 
tty52 22549 0:01 sh 

xtl62 lee 10:20 

tty08 6748 0:01 layers 
xtl62 6751 0:01 sh 
xtl63 6761 0:05 sh 
tty08 6536 0:05 sh 



FILES 

/etc/passwd 
/etc/ps_data 
/etc/utmp 

SEE ALSO 

ps(l), who(l). 
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NAME 

write - write to another user 

SYNOPSIS 

write user [ line ] 

DESCRIPTION 

The write command copies lines from your terminal to that of another user. 
When first called, it sends the message: 

Message from yourname (tty??) [ date ]. . . 

to the person you want to talk to. When it has successfully completed the 
connection, it also sends two bells to your own terminal to indicate that 
what you are typing is being sent. 

The recipient of the message should write back at this point. Communica- 
tion continues until an end of file is read from the terminal, an interrupt is 
sent, or the recipient has executed mesg n. At that point, write writes EOT 
on the other terminal and exits. 

If you want to write to a user who is logged in more than once, the line 
argument may be used to indicate which line or terminal to send to (e.g., 
ttyOO); otherwise, the first writable instance of the user found in /etc/utmp 
is assumed and the following message posted: 

user is logged on more than one place. 
You are connected to " terminal " . 
Other locations are: 
terminal 

Permission to write may be denied or granted by use of the mesg(l) com- 
mand. Writing to others is normally allowed by default. Certain com- 
mands, such as pr(l), disallow messages in order to prevent interference 
with their output. However, if the user has super-user permissions, mes- 
sages can be forced onto a write-inhibited terminal. 

If the character ! is found at the beginning of a line, write calls the shell to 
execute the rest of the line as a command. 

The following protocol is suggested for using write: When you first write to 
another user, wait for them to write back before starting to send. Each per- 
son should end a message with a distinctive signal [i.e., (o) for ''over"] so 
that the other person knows when to reply. The signal (oo) (for ''over and 
out") is suggested when conversation is to be terminated. 

FILES 

/etc/utmp to find user 
/bin/sh to execute ! 

SEE ALSO 

mail(l), mesg(l), pr(l), sh(l), who(l). 
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DIAGNOSTICS 

''user is not logged on" if the person you are trying to write to is not logged 
on. 

''Permission denied" if the person you are trying to write to denies that per- 
mission (with mesg). 

"Warning: cannot respond, set mesg -y" if your terminal is set to mesg n and 
the recipient cannot respond to you. 

"Can no longer write to user" if the recipient has denied permission {mesg n) 
after you had started writing. 
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NAME 

wtinit - object downloader for the 5620 DMD terminal 

SYNOPSIS 

/usr/lib/layersys/ wtinit [-d] [-p] file 

DESCRIPTION 

The wtinit utility downloads the named file for execution in the AT&T 
TELETYPE 5620 DMD terminal connected to its standard output, file must 
be a DMD object file, wtinit performs all necessary bootstrap and protocol 
procedures. 

There are two options: 

-d Prints out the sizes of the text, data, and bss portions of the down- 
loaded file on standard error. 

-p Prints the downloading protocol statistics and a trace on standard 
error. 

The environment variable JPATH is the analog of the shell's PATH variable 
to define a set of directories in which to search for file. 

If the environment variable DMDLOAD has the value hex, wtinit will use a 
hexadecimal download protocol that uses only printable characters. 

Terminal Feature Packages for specific versions of AT&T windowing termi- 
nals will include terminal-specific versions of wtinit under those installation 
sub-directories, /usr/lib/layersys /wtinit is used for layers{l) initialization 
only when no Terminal Feature Package is in use. 

EXIT STATUS 

Returns upon successful completion, 1 otherwise. 

WARNING 

Standard error should be redirected when using the -d or -p options. 

SEE ALSO 

layers(l). 
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NAME 

xargs - construct argument list(s) and execute command 
SYNOPSIS 

xargs [flags] [ command [initial-arguments] ] 
DESCRIPTION 

The xargs command combines the flxed initial-arguments with arguments 
read from standard input to execute the specified command one or more 
times. The number of arguments read for each command invocation and the 
manner in which they are combined are determined by the flags specified. 

command, which may be a shell file, is searched for, using one's $PATH. If 
command is omitted, /bin/echo is used. 

Arguments read in from standard input are defined to be contiguous strings 
of characters delimited by one or more blanks, tabs, or new-lines; empty 
lines are always discarded. Blanks and tabs may be embedded as part of an 
argument if escaped or quoted. Characters enclosed in quotes (single or 
double) are taken literally, and the delimiting quotes are removed. Outside 
of quoted strings a backslash (\) will escape the next character. 

Each argument list is constructed starting with the initial-arguments, fol- 
lowed by some number of arguments read from standard input (Exception: 
see -i flag). Flags -i, -1, and -n determine how arguments are selected for 
each command invocation. When none of these flags are coded, the initial- 
arguments are followed by arguments read continuously from standard input 
until an internal buffer is full, and then command is executed with the accu- 
mulated arguments. This process is repeated until there are no more argu- 
ments. When there are flag conflicts (e.g., -I vs. -n), the last flag has pre- 
cedence. Flag values are: 

-Inumber command is executed for each non-empty number lines 

of arguments from standard input. The last invoca- 
tion of command will be with fewer lines of arguments 
if fewer than number remain. A line is considered to 
end with the first new-line unless the last character of 
the line is a blank or a tab; a trailing blank/tab sig- 
nals continuation through the next non-empty line. If 
number is omitted, 1 is assumed. Option -x is forced, 

Areplstr Insert mode: command is executed for each line from 

standard input, taking the entire line as a single arg, 
inserting it in initial-arguments for each occurrence of 
replstr. A maximum of 5 arguments in initial- 
arguments may each contain one or more instances of 
replstr. Blanks and tabs at the beginning of each line 
are thrown away. Constructed arguments may not 
grow larger than 255 characters, and option -x is also 
forced. { } is assumed for replstr if not specified. 
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-nnumber Execute command using as many standard input argu- 

ments as possible, up to number arguments maximum. 
Fewer arguments will be used if their total size is 
greater than size characters, and for the last invoca- 
tion if there are fewer than number arguments remain- 
ing. If option -x is also coded, each number argu- 
ments must fit in the size limitation, else xargs ter- 
minates execution. 

-t Trace mode: The command and each constructed argu- 

ment list are echoed to file descriptor 2 just prior to 
their execution. 

-p Prompt mode: The user is asked whether to execute 

command each invocation. Trace mode (-t) is turned 
on to print the command instance to be executed, fol- 
lowed by a ?. . . prompt. A reply of y (optionally fol- 
lowed by anything) will execute the command; any- 
thing else, including just a carriage return, skips that 
particular invocation of command. 

-x Causes xargs to terminate if any argument list would 

be greater than size characters; -x is forced by the 
options -i and -1. When neither of the options -i, -1, 
or -n are coded, the total length of all arguments 
must be within the size limit. 

-ssize The maximum total size of each argument list is set to 

size characters; size must be a positive integer less 
than or equal to 470. If -s is not coded, 470 is taken 
as the default. Note that the character count for size 
includes one extra character for each argument and 
the count of characters in the command name. 

-eeofstr eofstr is taken as the logical end-of-file string. Under- 

bar (_) is assumed for the logic I EOF string if -e is 
not coded. The value -e with nc eofstr coded turns 
off the logical EOF string capability (underbar is taken 
literally), xargs reads standard input until either end- 
of-file or the logical EOF string is encountered. 

The xargs command will terminate if either it receives a return code of -1 
from, or if it cannot execute, command. When command is a shell program, 
it should explicitly exit [see sh(l)] with an appropriate value to avoid 
accidentally returning with -1. 
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EXAMPLES 

The following example will move all files from directory $1 to directory $2, 
and echo each move command just before doing it: 

Is $1 I xargs -i -t mv $l/{ } $2/{ } 

The following example will combine the output of the parenthesized com- 
mands onto one line, which is then echoed to the end of file log: 

(logname; date; echo $0 $*) I xargs »log 

The user is asked which files in the current directory are to be archived and 
archives them into arch (1.) one at a time or (2.) many at a time. 

1. Is I xargs -p -1 ar r arch 

2. Is ! xargs -p -1 I xargs ar r arch 

The following will execute diff{l) with successive pairs of arguments origi- 
nally typed as shell arguments: 

echo $* I xargs -n2 diff 

SEE ALSO 

sh(l). 
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NAME 

xfsck - check and repair XENIX filesystems 

SYNOPSIS 

/bin/xfsck [options] [filesystem] ... 

DESCRIPTION 

The xfsck command audits and interactively repairs inconsistent conditions 
for XENIX System V filesystems. If the filesystem is consistent, then xfsck 
reports number of files, number of blocks used, and number of blocks free. 
If the filesystem is inconsistent, the user is prompted whether or not xfsck 
should proceed with each correction. It should be noted that most correc- 
tive actions result in some loss of data. The amount and severity of the loss 
can be determined from the diagnostic output. If the user does not have 
write permission, xfsck defaults to the action of the -n option. 

The xfsck options are: 

-y Assumes a response to all questions asked by xfsck. 

-n Assumes a response to all questions asked by xfsck. This option does 
not open the filesystem for writing. 

-s b:c Ignores the actual free list and unconditionally reconstructs a new 
one by rewriting the super-block of the filesystem. The filesystem 
must be unmounted while this is done. 

This option allows for creating an optimal free-list organization. The 
following forms are supported: 

-s 

-sBlocks-per-cylinder:Blocks-to-skip (filesystem interleave) 

If b:c is not given, then the values that were used when the filesys- 
tem was created are used again. If these values were not specified, 
then the default value is used. 

-S Conditionally reconstructs the free list. This option is similar to -s b:c 
above, except that the free list is rebuilt only if there are no 
discrepancies discovered in the filesystem. The -S option forces a 
"no" response to all questions asked by xfsck. This option is useful 
for forcing free-list reorganization on uncontaminated filesystems. 

-t Causes xfsck to use the next argument as the scratch file, if needed. A 
scratch file is used if xfsck cannot obtain enough memory to keep its 
tables. Without the -t flag, xfsck prompts the user for the name of 
the scratch file. The file chosen should not be on the filesystem being 
checked. In addition, if the scratch file is not a special file or did not 
already exist, it is removed when xfsck completes. Note that if the 
system has a large hard disk, there may not be enough space on 
another filesystem for the scratch file. In such cases, if the system 
has a floppy disk drive, use a blank, formatted floppy disk in the 
floppy disk drive with (for example) /dev/fdO specified as the scratch 
file. 
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-q Causes xfsck to perform a quiet check. Does not print size-check 
messages in Phase 1. Unreferenced fifo5 files are selectively 
removed. If xfsck requires it, counts in the superblock are automati- 
cally fixed and the free list salvaged. 

-D Checks directories for bad blocks. Use this option after the system 
crashes. 

-f Causes xfsck to perform a fast check, xfsck checks block and sizes 
(Phase 1) and checks the free list (Phase 5). The free list is recon- 
structed (Phase 6), if necessary. 

-rr Recovers the root filesystem. The required filesystem argument must 
refer to the root filesystem, and preferably to the block device (nor- 
mally /dev/root). This switch implies -y (yes) and overrides -n (no). 
If any modifications to the filesystem are required, the system v^ill be 
automatically shutdown to ensure the integrity of the filesystem. 

-c Causes any supported filesystem to be converted to the current 
filesystem type. The user is prompted to verify the conversion of 
each filesystem, unless the -y option is specified. It is recommended 
that every filesystem be checked with this option while unmounted if 
it is to be used with the current version of XENIX. To update the 
active root filesystem, check it with the following command line: 

xfsck -c -rr /dev/root 

If no filesystems are specified, xfsck reads a list of default filesystems from 
the /etc/checklist file. 

The following are some of the inconsistencies xfsck checks for: 

Blocks claimed by more than one inode or the free list 

Blocks claimed by an inode or the free list outside the range of the 
filesystem 

- Incorrect link counts 

Size checks: 

Incorrect number of blocks 
Directory size not 16-byte aligned 

Bad inode format 

- Blocks not accounted for anywhere 

- Directory checks: 

File pointing to unallocated inode 
Inode number out of range 

Super block checks: 

More than 65536 inodes 

More blocks for inodes than there are in the filesystem 

- Bad free block list format 

- Total free block or free inode count incorrect 
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With the user's consent, xfsck reconnects orphaned (allocated, but unrefer- 
enced) files and directories by placing them in the lost+found directory. 
The file's (or directory's) inode number then becomes its name. Note that 
the lost+found directory must already exist in the root of the filesystem 
being checked and must have empty slots in which entries can be made. To 
create the lost+found directory, copy a few files to the directory, then 
remove them (before executing xfsck). 

FILES 

/etc/checklist Contains default list of filesystems to check 

/etc/default/boot Contains flags for automatic boot control 

SEE ALSO 

fsck(lM) 

NOTES 

xfsck will not run on a mounted non-raw filesystem, unless the filesystem is 
the root filesystem, or the -n option is specified and no writing out of the 
filesystem will take place. If any such attempt is made, xfsck displays a 
warning and no further processing of the filesystem is done for the specified 
device. 

WARNINGS 

xfsck does not support filesystems created under XENIX-86 version 3.0 
because the word order in type long variables has changed. However, xfsck 
is capable of auditing and repairing XENIX version 3.0 filesystems if the 
word ordering is correct. 

Run xfsck -rr /dev/root for the root filesystem. Run xfsck /dev/?? on 

the unmounted block device for all other filesystems. 

It is not recommended that users use xfsck on raw devices. Although check- 
ing a raw device is almost always faster, there is no way to tell if the 
filesystem is mounted. If the filesystem is mounted, cleaning it will almost 
certainly result in an inconsistent superblock. 
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NAME 

xinstall - XENIX installation shell script 

SYNOPSIS 

/etc/xinstall [ device ] 

DESCRIPTION 

/etc/xinstall is the sh(l) script used to install XENIX distribution (or appli- 
cation program) floppies. It performs the following tasks: 

- Prompts for insertion of floppies. 

- Extracts files using the tar(l) utility. 

- Executes /once/init.* programs on each floppy 
after they have been extracted. 

- Removes any /once/init* programs when the 
installation is finished. 

The optional argument to the command specifies the device used. The 
default device is /dev/xinstall and is normally linked to 
/dev/rdsk/£0ql5dt. 

FILES 

/etc/xinstall 

/once/init.* 

SEE ALSO 

custom(lM), fixperm(lM), installpkg(l). 

NOTES 

xinstall is provided for use with any existing XENIX packages you may have 
that you wish to install on the UNIX operating system, xinstall does not 
work with UNIX system applications [use installpkg(l) to install UNIX sys- 
tem applications]. 
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NAME 

xrestore, xrestor - invoke XENIX incremental filesystem restorer 

SYNOPSIS 

xrestore key [ arguments ] 

xrestor key [ arguments ] 
DESCRIPTION 

xrestore is used to read archive media backed up with the XENIX backup(C) 
command. The key specifies what is to be done. Key is one of the charac- 
ters rRxt, optionally combined with f. xrestor is an alternate spelling for the 
same command. 

f Uses the first argument as the name of the archive instead of the 

default. 

Fw«m Specifies the file number of the first volume to be restored. 

kvsize Specifies the size of the volume to be restored. 

r,R The archive is read and loaded into the filesystem specified in argu- 
ment. This should not be done lightly (see below). If the key is R, 
xrestore asks which archive of a multivolume set to start on. This 
allows xrestore to be interrupted and then restarted (an fsck must 
be done before the restart). 

X Each file on the archive named by an argument is extracted. The 

filename has all ''mount'' prefixes removed; for example, if /usr is 
a mounted filesystem, /usr/bin/Ipr is named /bin/lpr on the 
archive. The extracted file is placed in a file with a numeric name 
supplied by xrestore (actually the inode number). In order to keep 
the amount of archive read to a minimum, the following procedure 
is recommended: 

1 . Mount volume 1 of the set of backup archives. 

2. Type the xrestore command. 

3. Restore will announce whether or not it found the files, give 
the numeric name that it will assign to the file, and in the case 
of a tape, rewind to the start of the archive. 

4. It then asks you to "mount the desired tape volume". Type 
the number of the volume you choose. On a multivolume 
backup the recommended procedure is to mount the volumes, 
last through first. Restore checks to see if any of the requested 
files are on the mounted archive (or a later archive-thus the 
reverse order). If the requested files are not there, xrestore 
doesn't read through the tape. If you are working with a 
single-volume backup or if the number of files being restored 
is large, respond to the query with 1, and xrestore will read the 
archives in sequential order. 

Xfiles Puts files in the directory specified by arguments. 
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t Prints the date the archive was written and the date the filesystem 

was backed up. 

T This causes xrestore to behave like dumpdir(C) except that it doesn't 

list directories. 

The r option should only be used to restore a complete backup archive onto 
a clear filesysten\, or to restore an incremental backup archive onto a 
filesystem so created. Thus: 

/etc/mkfs /dev/dsk/0s3 10000 
xrestore r /dev/dsk/0s3 

is a typical sequence to restore a complete backup. Another xrestore can be 
done to get an incremental backup in on top of this. 

A backup followed by a mkfs and a xrestore is used to change the size of a 
filesystem. 

FILES 

rst* Temporary files 

/etc/default/xrestore Name of default archive device 
The default archive unit varies with installation. 

NOTES 

xrestore is for XENIX compatibility and should only be used to restore 
filesystems that were backed up under XENIX. 

It is not possible to successfully restore an entire active root filesystem. 
DIAGNOSTICS 

There are various diagnostics involved with reading the archive and writing 
the disk. There are also diagnostics if the i-list or the free list of the filesys- 
tem is not large enough to hold the dump. 

If the dump extends over more than one disk or tape, it may ask you to 
change disks or tapes. Reply with a NEWLINE when the next unit has been 
mounted. 
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NAME 

xtd - extract and print xt driver link structure 

SYNOPSIS 

xtd [-f] [-n ...] 

DESCRIPTION 

The xtd command is a debugging tool for the xt{7) driver. It performs an 
XTIOCDATA ioctl(2) call on its standard input file to extract the Link data 
structure for the attached group of channels. This call will fail if data 
extraction has not been configured in the driver or the standard input is not 
attached to an xt(7) channel. The data are printed one item per line on the 
standard output. The output should probably be formatted via pr -3. 

The optional flags affect output as follows: 

-n « is a number in the range to 7. Channel n is included in the 
list of channels to be printed. The default prints all channels, 
whereas the occurrence of one or more channel numbers implies 
a subset. 

-f Causes a ''formfeed" character to be put out at the end of the 
output for the benefit of page-display programs. 

EXIT STATUS 

Returns upon successful completion; 1 otherwise. 

SEE ALSO 

pr(l), xts(lM), xtt(lM), xt(7). 

ioctl(2), xtproto(5) in the Programmer's Reference Manual. 
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NAME 

xts - extract and print xt driver statistics 

SYNOPSIS 

xts [-f] 

DESCRIPTION 

The xts command is a debugging tool for the xt(7) driver. It performs an 
XTIOCSTATS ioctl{l) call on its standard input file to extract the accumu- 
lated statistics for the attached group of channels. This call will fail if statis- 
tics have not been configured in the driver, or the standard input is not 
attached to an xt{7) channel. The statistics are printed one item per line on 
the standard output. 

-f Causes a ''formfeed" character to be put out at the end of the out- 

put for the benefit of page-display programs. 

EXIT STATUS 

Returns upon successful completion; 1 otherwise. 

SEE ALSO 

xtd(lM), xtt(lM), xt(7). 

ioctl(2), xtproto(5) in the Programmer's Reference Manual. 
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NAME 

xtt - extract and print xt driver packet traces 

SYNOPSIS 

xtt [-{] [-0] 

DESCRIPTION 

The xtt command is a debugging tool for the xt(7) driver. It performs an 
XTIOCTRACE ioctl{2) call on its standard input file to turn on tracing and 
extract the circular packet trace buffer for the attached group of channels. 
This call will fail if tracing has not been configured in the driver, or the 
standard input is not attached to an xt(7) channel. The packets are printed 
on the standard output. 

The optional flags are: 

-f Causes a "formfeed" character to be put out at the end of the out- 
put for the benefit of page-display programs. 

-o Turns off further driver tracing. 

EXIT STATUS 

Returns upon successful completion; 1 otherwise. 

NOTE 

If driver tracing has not been turned on for the terminal session by invoking 
layers(l) with the -t option, xtt will not generate any output the first time it 
is executed. 

SEE ALSO 

layers(l), xtd(lM), xts(lM), xt(7). 

ioctl(2), layers(5) in the Programmer's Reference Manual. 
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NAME 

yes - repeatedly print string 

SYNOPSIS 

yes [ string ] 

DESCRIPTION 

The yes command repeatedly outputs "y", or if a single string argument is 
given, arg is output. The command continues indefinitely unless aborted. 
Yes is useful in pipes to commands that prompt for input and require a "y" 
response for a yes. In this case, yes terminates when the command that it 
pipes to terminates, so that no infinite loop occurs. 
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NAME 

intro - introduction to special files 
DESCRIPTION 

This section describes various special files that refer to specific hardware 
peripherals and UNIX system device drivers. STREAMS [see intro(2)] software 
drivers, modules, and the STREAMS-generic set of ioctl{2) system calls are 
also described. 

For hardware-related files, the names of the entries are generally derived 
from names for the hardware, as opposed to the names of the special files 
themselves. Characteristics of both the hardware device and the 
corresponding UNIX system device driver are discussed where applicable. 

Disk device file names are in the following format: 

/dev/{r}dsk/#s# 

where r indicates a raw interface to the disk, the first # indicates the drive 
number, and the second # indicates the section number of the partitioned 
device. 

SEE ALSO 

Disk/Tape Management in the Operations /System Administration Guide. 



- 1 - 



ASY(7) 



ASY(7) 



NAME 

asy - asynchronous serial port 
DESCRIPTION 

The asy driver supports both the system board serial port and an additional 
serial adapter simultaneously. Up to two serial ports are supported. If an 
adapter for a port is not installed, an attempt to open it will fail. The port 
can be programmed for speed (50 — 19200 baud), character length, and par- 
ity. Output speed is always the same as input speed. The port behaves as 
described in temiio{7). 

The asynchronous port is a character-at-a-time device for both input and 
output. This characteristic both limits the bandwidth which can be achieved 
over a line, and increases the interrupt loading on the central processor. In 
particular, file transfer programs such as uucp{l) may not function well at 
speeds over 4800 baud. 

The baud rates of the serial adapter programmable baud-rate generator do 
not correspond exactly with system baud rates. In particular, setting BO will 
cause a disconnect, setting EXTA will set 19200 baud, and setting EXTB will 
set 38400 baud. It is not possible to directly set 2000, 3600, or 7200 baud. 

FILES 

/dev/tty* 

SEE ALSO 

signal(2), termio(7). 
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NAME 

clone - open any minor device on a STREAMS driver 
DESCRIPTION 

clone is a STREAMS software driver that finds and opens an unused minor 
device on another STREAMS driver. The minor device passed to clone dur- 
ing the open is interpreted as the major device number of another STREAMS 
driver for which an unused minor device is to be obtained. Each such open 
results in a separate stream to a previously unused minor device. 

The clone driver consists solely of an open function. This open function 
performs all of the necessary work so that subsequent system calls [includ- 
ing closed)] require no further involvement of clone, 

clone will generate an ENXIO error, without opening the device, if the 
minor device number provided does not correspond to a valid major device, 
or if the driver indicated is not a STREAMS driver. 

CAVEATS 

Multiple opens of the same minor device cannot be done through the clone 
interface. Executing stat(2) on the file system node for a cloned device 
yields a different result from executing fstat(2) using a file descriptor 
obtained from opening the node. 

SEE ALSO 

log(7). 

STREAMS Programmer's Guide. 
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NAME 

console - console interface 
DESCRIPTION 

The console provides the operator interface to the computer. 
The file /dev/console is the system console, and refers to the video adaptor 
and keyboard. This special file implements the features described in ter- 
mio(7), display{7), and keyboard{7). 

HLES 

/dev/console 

/dev/vtmon 

/dev/vtOO 

SEE ALSO 

termio(7), display(7), keyboard(7). 
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NAME 

cram - CMOS RAM interface 
DESCRIPTION 

The cram driver provides an interface to the 64 bytes of battery backed-up 
RAM. This memory contains information such as diagnostics and confi- 
guration information. 

locti Calls 

CMOSREAD 

This call is used to read the contents of one of the CMOS RAM 
locations. The argument to the ioctl is the address of a buffer of 
tv^o unsigned characters, the first of which is the address to be read. 
The ioctl will fill in the second byte with the data. An address less 
than or greater than 63 will result in an error, with errno set to 
ENXIO. 

CMOSWRITE 

This call is used to write a value into one of the CMOS RAM loca- 
tions. The argument to the ioctl is the address of a buffer of two 
unsigned characters, the first of which is the address and the second 
of which is the value to write at that address. An address less than 
or greater than 63 will result in an error, with errno set to ENXIO. 
Note that only the super-user may open the CMOS RAM device for 
writing, and that the CMOSWRITE ioctl will fail for any other than 
the super-user. 

FILES 

/dev/cram 
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NAME 

disk - random access bulk storage medium 
DESCRIPTION 

The secondary storage devices used by the system are fixed disks and 
diskettes. Disks are high-speed rotating magnetic media, which are treated 
as a collection of concentric rings, known as tracks. There are several 
platters (whose number is represented by n) in the fixed disk providing up 
to two surfaces per platter (or a total of up to 2n surfaces); each set of up to 
2n parallel tracks on these surfaces is considered as a group, known as a 
cylinder. Each track is divided into several sectors. A sector is usually the 
smallest unit which can be transferred to or from the disk. However, the 
drivers allow read or write operations of any size to or from any location on 
the disk, except for raw disks. 

Logical Disks 

It is often useful to partition fixed physical disks into smaller sections, each 
of which can hold a separate file system. The disk device driver can there- 
fore divide a physical disk into smaller logical disks or partitions. Each of 
these logical sub-disks behaves as if it were a distinct disk. A typical divi- 
sion of a disk into logical sub-disks might be as follows: 

/dev/dsk/OsO represents the entire disk on drive 
/dev/dsk/Osl represents the first partition on drive 
/dev/dsk/0s2 represents the second partition on drive 
/dev/dsk/lsO represents the entire disk on drive 1 
/dev/dsk/lsl represents the first partition on drive 1 
/dev/dsk/ls2 represents the second partition on drive 1 

and similarly for the raw (character) logical disks, /dev/rdsk/OsO, 
/dev/rdsk/Osl, etc. 

In fact, more complex arrangements are often created. It is often desirable 
to have logical disks of different sizes, which are suited to different uses. 
Similarly, it is often desirable to have several alternative ways of partition- 
ing a single disk. Refer to install(lM) and mkpart{lM) for the details of par- 
titioning of a disk. Instructions for partitioning are described in the 
Operations /System Administration Guide. 

SEE ALSO 

fdisk(lM), install(lM), mkpart(lM), fd(7), hd(7), intro(7). 
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NAME 

display - system console display 
DESCRIPTION 

The system console (and user's terminal) is composed of two separate 
pieces: the keyboard [see keyhoard{7)] and the display. Because of their 
complexity, and because there are three possible display interfaces (mono- 
chrome, color graphics, and enhanced graphics adapters), they are discussed 
in separate manual entries. 

The display normally consists of 25 lines of 80 columns each; 40-column 
lines are also supported by the color/graphics adapter, and 43 lines of 80- 
columns each are supported by the enhanced graphics adapter. Writing 
characters to the console or one of its virtual screens (/dev/console or 
/dev/vto) has an effect which depends on the characters. All characters 
written to /dev/console are first processed by the terminal interface [see 
termio{7)]. For example, mapping new-line characters to carriage return plus 
new-line, and expanding tabs to spaces, will be done before the following 
processing: 

X Where x is not one of the following, displays x, 

BEL Generates a bell (audible tone, no modulation). 

CR Places the cursor at column 1 of the current line. 

LP, VT Places the cursor at the same column of the next line (scrolls if the 

the current line is line 25). 
FF Clears the screen and places the cursor at line 1, column 1. 
BS Depends on the previous character: if a _ (underscore), see below; 
otherwise, if the cursor is not at column 1, it is moved to the left 
one position on the same line. If the cursor is at column 1 but not 
line 1, it is moved to column 79 of the previous line. Finally, if the 
cursor is at column 1, line 1, it is not moved. 
_BS:c Sets the underscore attribute for the character x to be displayed. 
The underscore attribute for the color/graphics adapter is a red 
background with a white foreground. 
ESCx Where x is any of the 256 possible codes (except for c and [), 
displays that value uninterpreted. This is useful for utilizing the 
full set of graphics available on the display. Note again that the 
characters are processed through the terminal interface prior to this 
escape sequence. Therefore, to get some of the possible 256 charac- 
ters it is necessary that the character not be postprocessed. The 
easiest way to accomplish this is to turn off OPOST in the C-oflag 
field [see termio(7)]; however, this may have other side effects. 
The display can be controlled by means of ANSI X3.64 escape sequences, 
which are specific sequences of characters, preceded by the ASCII character 
ESC. The escape sequences, which work on either the monochrome, color 
graphics, or enhanced graphics adapter, are the following: 
ESCc Clears the screen and places the cursor at line 1, column 1. 
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ESC Q n 'string' 

Defines the function key n with string. The string delimiter ' 
may be any character not in string. Function keys are num- 
bered through 11 (Fl = 0, F2 = 1, etc.) 

ESC[ n @ Insert character — inserts n blanks at the current cursor posi- 
tion. 

ESC[ n ' Horizontal Position Absolute — moves active position to 
column given by n. 

ESC[ n A Cursor up — moves the cursor up n lines (default: n=l). 

ESC[ n a Horizontal Position Relative — moves active position n char- 
acters to the right (default: w=l). 

ESC[ n B Cursor down — moves the cursor down n lines (default: 
n=l). 

ESC[ n C Cursor right — moves the cursor right n columns (default: 
n=l). 

ESC[ n D Cursor left — moves the cursor left n columns (default: n=l). 

ESC[ n d Vertical Position Absolute — moves active position to line 
given by n. 

ESC[ n E Cursor next line — moves the cursor to column 1 of the next 
line, then down n-1 lines (default: n=l). 

ESC[ n e Vertical Position Relative — moves the active position down n 
lines (default: n=l). 

ESC[ n F Cursor previous line — moves the cursor to column 1 of the 
current line, then up n lines (default: n=l). 

ESC[ n G Cursor horizontal position — moves the cursor to column n of 
the current line (default: n=l). 

ESC[ n ; mH Position cursor — moves the cursor to column m of line n 
(default: n=l, m=l). 

ESC[ n ; m f Position cursor — moves the cursor to column m of line n 
(default: w=l, m=l). 

ESC[ n J Erase window — erases from the current cursor position to the 
end of the window if n=0, from the beginning of the win- 
dow to the current cursor position if n=l, and the entire win- 
dow if n=2 (default: n=0). 

ESC[ n K Erase line — erases from the current cursor position to the end 
of the line if «=0, from the beginning of the line to the 
current cursor position if n=l, and the entire line if n=2 
(default: n=0). 

ESC[ n L Insert line — inserts n lines at the current cursor position 
(default: n=l). 

ESC[ n M Delete line — deletes n lines starting at the current cursor 
position (default: n=l). 
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ESC[ n P Delete character — deletes n characters from a line starting at 
the current cursor position (default: n=l). 

ESC[ n S Scroll up— scrolls the characters in the current window up n 
lines. The bottom n lines are cleared to blanks (default: 
n=l). 

ESC[ n T Scroll down— scrolls the characters in the current window 
down n lines. The top n lines are cleared to blanks (default: 
n=l). 

ESC[ n X Erase character— erases n character positions starting at the 

current cursor position (default: n=l). 
ESC[ n Z Cursor Backward Tabulation— moves active position back n 

tab stops. 

ESC[2h Locks the keyboard and ignores keyboard input until 

unlocked. Characters are not saved. 
ESC[ 2i Sends the screen to the host. The current screen display is 

sent to the application. 
ESC[ 21 Unlocks the keyboard. Re-enables keyboard input. 



ESC[ Ps ; Ps; 



m 

Character attributes— each Ps is one of the following charac- 
ters; multiple characters are separated by semicolons. These 
parameters apply to successive characters being displayed, in 
an additive manner (e.g., both bold and underscoring can be 
selected). Only the parameters through 7 apply to the mono- 
chrome adapter; all parameters apply to the color/graphics 
adapter and the enhanced graphics adapter. (Default: Ps=0). 
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Ps 



ESq 11 m 
ESq 12 m 

ESq 38 m 
ESCf 39 m 



Meaning 

all attributes off (normal display) 
(white foreground with black background) 
bold intensity 
underscore on 

(white foreground with red background on color) 
blink on 
reverse video 

foreground 
foreground 
foreground 
foreground 
foreground 
foreground 
foreground 
foreground 
background 
background 
background 
background 
background 
background 
background 
background 



selects the first alternate font; lets ASCII charac- 
ters less than 32 be displayed as ROM characters 
selects a second alternate font; toggles high bit of 
extended ASCII code before displaying as ROM 
characters 

enables underline option; white foreground with 

white underscore (see WARNINGS) 

disables underline option; see WARNINGS 



30 


black 


(gray) 


31 


red 


(light red) 


32 


green 


(light green) 


33 


brown 


(yellow) 


34 


blue 


(light blue) 


35 


magenta 


(light magenta) 


36 


cyan 


(light cyan) 


37 


white 


(bright white) 


40 


black 


(gray) 


41 


red 


(light red) 


42 


green 


(light green) 


43 


brown 


(yellow) 


44 


blue 


(light blue) 


45 


magenta 


(light magenta) 


46 


cyan 


(light cyan) 


47 


white 


(bright white) 


ESC[ 8 m 


sets blank (non-display) 


ESC[ 10 m 


selects the primary font 



Note that for character attributes 30-37, the color selected for 
foreground will depend on whether the bold intensity attri- 
bute (1) is currently on. If not, the first color listed will 
result; otherwise the second color listed will result. 

Similarly, for character attributes 40-47, the color selected for 
background will depend on whether the blink attribute (5) is 
currently on. If the blink attribute is not on, then the first 
color listed will result. If the blink attribute is on, then the 
second color listed will result. 

ESC[ Pn d CSIPn d 

Moves the cursor to the line specified by Pn. 
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loctl Calls 

The following ioctl calls may be used to change the display used for the 

video monitor. 

SWAPMONO 

This call selects the monochrome adapter as the output device for 
the system console. 

SWAPCGA 

This call selects the color/graphics adapter as the output device for 
the system console. 

SWAPEGA 

This call selects the enhanced graphics adapter as the output device 

for the system console. 
The foUov^ing ioctl call may be used to obtain more information about the 
display adapter currently attached to the video monitor: 

CONS-CURRENT 

This call returns the display adapter type currently attached to the 
video monitor. The return value can be one of: MONO, CGA, or 
EGA. 

The following ioctl calls may be used to switch display modes on the vari- 
ous video adapters: 
SW_B40x25 

This call selects 40x25 (40 columns by 25 rows) black and white 
text display mode. It is valid only for CGA and EGA devices. 

SW_C40x25 

This call selects 40x25 (40 columns by 25 rows) color text display 
mode. It is valid only for CGA and EGA devices. 

SW_B80x25 

This call selects 80x25 (80 columns by 25 rows) black and white 
text display mode. It is valid only for CGA and EGA devices. 

SW_C80x25 

This call selects 80x25 (80 columns by 25 rows) color text display 
mode. It is valid only for CGA and EGA devices. 

SW_BG320 

This call selects 320x200 black and white graphics display mode. It 
is valid only for CGA and EGA devices. 

SW_CG320 

This call selects 320x200 color graphics display mode. It is valid 
only for CGA and EGA devices. 

SW_-BG640 

This call selects 640x200 black and white graphics display mode. It 
is valid only for CGA and EGA devices. 

SW_CG320_D 

This call selects EGA support for 320x200 graphics display mode 
(EGA mode D). It is valid only for EGA devices. 
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SW_CG640_E 

This call selects EGA support for 640x200 graphics display mode 
(EGA mode E). It is valid only for EGA devices. 

SW_EGAMONOAPA 

This call selects EGA support for 640x350 graphics display mode 
(EGA mode F). It is valid only for EGA devices. 

SW_ENHMONOAPA2 

This call selects EGA support for 640x350 graphics display mode 
with extended memory (EGA mode F*). It is valid only for EGA 
devices. 

SW_CG640x350 

This call selects EGA support for 640x350 graphics 
(EGA mode 10). It is valid only for EGA devices. 

SW_ENH_CG640 

This call selects EGA support for 640x350 graphics 
with extended memory (EGA mode 10*). It is valid 
devices. 

SW_£GAMONO80x25 

This call selects EGA monochrome text display mode (EGA mode 
7), which emulates support provided by the monochrome adapter. 
It is valid only for EGA devices. 

SW_ENHB40x25 

This call selects enhanced 40x25 black and white text display mode. 
It is valid only for EGA devices. 

SW_ENHC40x25 

This call selects enhanced 40x25 color text display mode. It is valid 
only for EGA devices. 

SW_ENHB80x25 

This call selects enhanced 80x25 black and white display mode. It 
is valid only for EGA devices. 

SW-JENHC80x25 

This call selects enhanced 80x25 color text display mode. It is valid 
only for EGA devices. 

SW_ENHB80x43 

This call selects enhanced 80x43 black and white text display mode. 
It is valid only for EGA devices. 

SW_ENHC80x43 

This call selects enhanced 80x43 color text display mode. It is valid 
only for EGA devices. 

SW__MCAMODE 

This call reinitializes the monochrome adapter. It is valid only for 
monochrome adapters. 



display mode 



display mode 
only for EGA 
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SW_-ATT_640 

This call selects 640x400 16 colormode, when an AT&T Super- Vu 

video controller is attached. 
Switching to an invalid display mode for a display device will result in an 
error. 

The following ioctls may be used to obtain information about the current 

display modes: 

CONS_GET 

This call returns the current display mode setting for whatever 
display adapter is being used. Possible return values include: 

M__B40x25 (0), black and white 40 columns. CGA and EGA only. 
M_C40x25 (1), color 40 columns. CGA and EGA only. 
M_B80x25 (2), black and white 80 columns. CGA and EGA only. 
NLC80X25 (3), color 80 columns. CGA and EGA only. 
M_BG320 (4), black and white graphics 320 by 200. CGA and 
EGA only. 

M_CG320 (5), color graphics 320 by 200. CGA and EGA only. 
M_BG640 (6), black and white graphics 640 by 200 high-resolution. 
CGA and EGA only. 

M_JEGAMONO80x25 (7), EGA-mono 80 by 25. EGA only. 
M_CG320_D (13), EGA mode D. 
M_CG640_JE (14), EGA mode E. 
M_JEFAMONOAPA (15), EGA mode F. 
M_CG640x350 (16), EGA mode 10. 

M_ENHMONOAPA2 (17), EGA mode F with extended memory. 
M__ENH_CG640 (18), EGA mode 10*. 

M_ENH_B40x25 (19), EGA enhanced black and white 40 columns. 
M_ENH__C40x25 (20), EGA enhanced color 40 columns. 
M__ENH_B80x25 (21), EGA enhanced black and white 80 columns. 
M_ENH-C80x25 (22), EGA enhanced color 80 columns. 
M_ENH_B80x43 (0x70), EGA black and white 80 by 43. 
M_ENFL_C80x43 (0x71), EGA color 80 by 43. 
NLMCA__MODE (Oxff), monochrome adapter mode. 
MCA-GET 

This call returns the current display mode setting of the mono- 
chrome adapter. See CONS_GET for a list of return values. If the 
monochrome adapter is not installed, the call will fail and erno will 
be set to 22 (EINVAL). 
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CGA_GET 

This call returns the current display mode setting of the 
color/graphics adapter. See CONS_GET for a list of return values. 
If the color graphics adapter is not installed, the call will fail and 
emo will be set to 22 (EINVAL). 

EGA_GET 

This call returns the current display mode seting of the enhanced 
graphics adapter. See CONS_GET for a list of return values. If the 
enhanced graphics adapter is not installed, the call will fail and emo 
will be set to 22 (EINVAL). 

The following ioctl calls may be used to map the video adapter's memory 
into the user's data space. 

MAPCONS 

This call maps the display memory of the adapter currently being 
used into the user's data space. 

MAPMONO 

This call maps the monochrome adapter's display memory into the 
user's data space. 

MAPCGA 

This call maps the color/graphics adapter's display memory into the 
user's data space. 

MAPEGA 

This call maps the enhanced graphics adapter's display memory into 
the user's data space. 

You can use ioctl calls to input a byte from the graphics adapter port or to 
output a byte to the graphics adapter port. The argument to the ioctl uses 
the port—io—arg data structure: 

struct port_io_arg { 

struct port_io__struc_args[4]; 

}' 

As shown in the previous example, the port^io—urg structure points to an 
array of four port—io^truc data structures. The port—io^truc has the fol- 
lowing format: 

struc port_io_struc { 

char dir; /*direction flag (in vs. out)*/ 

unsigned short port; /*port address*/ 
char data; /*byte of data*/ 

}' 

You can specify one, two, three, or four of the port— io— struc structures in 
the array for one ioctl call. The value of dir can be either IN_ON__PORT 
(to specify a byte being input from the graphics adapter port) or 
OUT_ON_PORT (to specify a byte being output to the graphics adapter 
port). Port is an integer specifying the port address of the desired graphics 
adapter port. Data is the byte of data being input or output as specified by 
the call. If you are not using any of the port—io^truc structures, load the 
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port with 0, and leave the unused structures at the end of the array. Refer 
to your hardware manuals for port addresses and functions for the various 
adapters. 

The following ioctl calls may be used to input or output bytes on the graph- 
ics adapter port: 

MCAIO This call inputs or outputs a byte on the monochrome adapter 
port as specified. 

CGAIO This call inputs or outputs a byte on the color/graphics adapter 
port as specified. 

EGAIO This call inputs or outputs a byte on the enhanced graphics 

adapter port as specified. 
To input a byte on any of the graphics adapter ports, load dir with 
IN_ON_PORT and load port with the port address of the graphics adapter. 
The byte input from the graphics adapter port will be returned in data. 
To output a byte, load dir with OUT_ON_PORT, load port with the port 
address of the graphics adapter, and load data with the byte you want to 
output to the graphics adapter port. 

The following ioctls may be used with either the monochrome, color graph- 
ics, or enhanced graphics adapters: 
KDDISPTYPE 

This call returns display information to the user. The argument 
expected is the buffer address of a structure of type kd—disparam 
into which display information is returned to the user. The 
kd—disparam structure is defined as follows: 

struct kd_disparam { 

long type; /*display type*/ 

char *addr; /*display memory address*/ 

ushort ioaddr[MKDIOADDR]; /*valid I/O addresses*/ 

} 

Possible values for the type field include: 

KD__MONO (0x01), for the IBM monochrome display adapter. 

KD_HERCULES (0x02), for the Hercules monochrome graphics 

adapter. 

KD_CGA (0x03), for the IBM color graphics adapter. 
KD^EGA (0x04), for the IBM enhanced graphics adapter. 
KIOCSOUND 

Start sound generation. Turn on sound. The "arg" is the fre- 
quency desired. A frequency of turns off the sound. 

KDGETLED 

Get keyboard LED status. The argument is a pointer to a character. 
The character will be filled with a boolean combination of the fol- 
lowing values: 

LED_SCR 0x01 ( flag bit for scroll lock ) 
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LED_CAP 0x04 ( flag bit for caps lock ) 

LED__NUM 0x02 ( flag bit for num lock ) 

KDSETLED 

Set keyboard LED status. The argument is a character whose value 
is the boolean combination of the values listed under "KDGE- 
TLED". 

KDMKTONE 

Generate a fixed length tone. The argument is a 32 bit value, with 
the lower 16 bits set to the frequency and the upper 16 bits set to 
the duration (in milliseconds). 

KDGKBTYPE 

Get keyboard type. The argument is a pointer to a character type. 
The character will be returned with one of the following values: 

KB_84 0x01 ( 84 key keyboard ) 

KB_101 0x02 ( 101 key keyboard ) 

KB_OTHER 0x03 

KDADDIO 

Add I/O port address to list of valid video adaptor addresses. 
Argument is an unsigned short type which should contain a valid 
port address for the installed video adaptor. 

KDDELIO 

Delete I/O port address from list of valid video adaptor addresses. 
Argument is an unsigned short type which should contain a valid 
port address for the installed video adaptor. 

KDENABIO 

Enable in's and out's to video adaptor ports. No argument. 
KDDISABIO 

Disable in's and out's to video adaptor ports. No argument. 
KDQUEMODE 

Enable/Disable special queue mode. Queue mode is used by 
AT&T's X-Windows software to establish a shared queue for access 
to keyboard and mouse event information. The argument is a 
pointer to a structure " kd_quemode " . If a NULL pointer is sent as 
an argument, the queue will be closed and the mode disabled. The 
structure "kd-_quemode" is as follows: 

struct kd_quemode { 

int qsize; /* desired # of elements in queue * / 
int signo; /* signal number to send when queue 

goes non-empty */ 
char *qaddr; /* user virtual address of queue (set by 

driver) */ 
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KDSBORDER 

Set screen color border in EGA text mode. The argument is of type 
character. Each bit position corresponds to a color selection. From 
bit position to bit position 6, the color selections are respectively; 
blue, green, red, secondary blue, secondary green, and secondary 
red. Setting the bit position to a logic one will select the desired 
color or colors. See WARNINGS below. 

KDSETMODE 

Set console in text or graphics mode. The argument is of type 
integer, which should contain one of the following values: 

KD_TEXT 0x00 ( sets console to text mode ) 

KD_GRAPHICS 0x01 ( sets console in graphics mode ) 

Note, the user is responsible for programming the color/graphics 
adaptor registers for the appropriate graphical state. 

KDGETMODE 

Get current mode of console. Returns integer argument containing 
either KD_TEXT or KD_GRAPHICS as defined in the KDSET- 
MODE ioctl description. 

KDMAPDISP 

Maps display memory into user process address space. Argument is 
a pointer to structure type " kd_memloc " . Structure definition is as 
follows: 

struct kd_memloc { 

char *vaddr; /* virtual address to map to */ 

char *physaddr; /* physical address to map from */ 

long length; /* size in bytes to map */ 

long ioflg; /* enable i/o addresses if set */ 

} 

KDUNMAPDISP 

Unmap display memory from user process address space. No argu- 
ment required. 

VT_OPENQRY 

Find an available virtual terminal. The argument is a pointer to a 
long. The long will be filled with the number of the first available 
"VT" that no other process has open or -1 if none are available. 

VT_GETMODE 

Determine what mode the active virtual terminal is currently in, 
either VT_AUTO or VT_PROCESS. The argument to the ioctl is 
the address of the following type of structure: 

struct vt__mode { 

/* VT mode */ 

/* if set, hang on writes when not active */ 
/* signal to use for release request */ 
/* signal to use for display acquired */ 
/* signal to use for forced release */ 



char 


mode; 


char 


waitv; 


short 


relsig; 


short 


acqsig; 


short 


frsig; 


} 
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#define VT_AUTO 0x00 /* automatic VT switching */ 
#define VT_PROCESS 0x01 /* process controls switching */ 

The "vt_jnode" structure will be filled in with the current value for 
each field. 

VT_SETMODE 

Set the virtual terminal mode. The argument is a pointer to a 
"vt_-mode" structure, as defined above. 

VT_RELDISP 

Used to tell the virtual terminal manager that the display has or has 
not been released by the process. A non-zero argument indicates 
that the display has been released; a zero argument indicates refusal 
to release the display. 

VT_ACTIVATE 

Makes the virtual terminal number specified in the argument the 
active "VT". The "VT" manager will cause a switch to occur in 
the same manner as if a hotkey sequence had been typed at the 
keyboard. If the specified "VT" is not open or does not exist, the 
call will fail and ermo will be set to ENXIO. 

KIOCINFO 

This call tells the user what the device is. 

GIO_SCRNMAP 

This call gets the screen mapping table from the kernel. 

GIO_ATTR 

This call returns the current screen attribute. The bits are inter- 
preted as follows: 

Bit determines underlining for black and white monitors 
(l=underlining on). 

Bits 0-2, for color monitors only, select the foreground color. The 
following list indicates what colors are selected by the given value: 

The value selects black. 
The value 1 selects red. 
The value 2 selects green. 
The value 4 selects blue. 
The value 5 selects magenta. 
The value 6 selects cyan. 
The value 7 selects white. 

Bit 3 is the intensity bit ( l=blink on). 

Bits 4-6, for color monitors only, select the background color. For a 
list of colors and their values, see the list under foreground colors. 

Bit 7 is the blink bit (l=blink on). 

GIO_COLOR 

This call returns a non-zero value if the current display is a color 
display, otherwise, it returns a zero. 
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PIO_SCRNMAP 

This call puts the screen mapping table in the kernel. 

The screen mapping table maps extended ASCII (8-bit) characters to ROM 
characters. It is an array [256] of char (typedef scrnmap—t) and is indexed 
by extended ASCII values. The value of the elements of the array are the 
ROM character to display. 

For example, the following will change the ASCII character to be 
displayed as an English pound sign. 

#include <sys/console.h> 
change_pound() { 
scrnmap_t scmtab; 

/*get screen mapping table of standard output*/ 
if (ioctl(0,GIO_SCRNMAP, scmtab)==-l) 

{ 

perror( " screenmap read " ); 
exit(-l); 

} 

/*156 is the ROM value of English pound sign and 30 
is the ASCII value of '#'. 

V 

scmtab[30] = 156; 

if (ioctl(0, PIO_SCRNMAP, scrntab) == -1) 

{ 

perror( " screenmap write " ); 
exit(-l); 

} 

} 

FILES 

/dev/console 

/dev/vtOO-w 

/usr /include /sys /kd.h 

SEE ALSO 

stty(l), console(7), keyboard(7), termio(7). 
ioctl(2) in the Programmer's Reference Manual. 
WARNINGS 

Although it is possible to write character sequences which set arbitrary bits 
on the screen in any of the three graphics modes, this mode of operation is 
not currently supported. 

Enable/disable of the underscore option using "ESC [ 38 m" and 
"ESC [ 39 m" are operative only when the AT&T Rite-Vu color/graphics 
video adaptor is installed, or else the underscore option is unsupported as 
the default for all other color/graphics adaptors. Monochrome adaptors 
support underscore option as the default. 

It is currently not possible to access the 6845 start address registers. Thus, 
it is impossible to determine the beginning of the color monitor's screen 
memory. 
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The alternate/background color bit (bit 4) of the color select register does 
not appear to affect background colors in alphanumeric modes. 

KDSBORDER ioctl calls will not work with AT&T's Super- Vu enhanced 
color/graphics video adaptor. It will however, work with the IBM EGA 
card and other EGA compatible video adaptors. 

The low-resolution graphics mode appears to be 80 across by 100 down. 
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NAME 

fd - diskette (floppy disk) 
DESCRIPTION 

The diskette driver provides access to diskettes as both block and character 
devices. Diskettes must be formatted before their use [see format(l)]. Both 
5.25" and 3.50" diskette formats are supported. The driver controls up to 
two diskette drives. The minor device number specifies the drive number, 
the format of the diskette and the partition number. 

Diskette device file names (which correspond to a specific major and minor 
device) use the following format: 

/dev/{r}dsk/f {0,1} {5h,5d9,5d8,5d4,5dl6,5q,3h,3d} {t,u} 

where r indicates a raw (character) interface to the diskette, rdsk selects the 
raw device interface and dsk selects the block device interface. or 1 
selects the drive to be accessed: £0 selects floppy drive 0, while fl selects 
drive 1. The following list describes the format to be interacted with: 

high density diskette (1.2MB). 

double density diskette, 9 sectors per track (360KB). 
double density diskette, 8 sectors per track (320KB). 
double density diskette, 4 sectors per track (320KB). 
double density diskette, 16 sectors per track (320KB). 
quad density diskette (720KB). 
high density diskette (1.44MB). 
double density diskette (720KB). 



5h 


5.25 


5d9 


5.25 


5d8 


5.25 


5d4 


5.25 


5dl6 


5.25 


5q 


5.25 


3h 


3.50 


3d 


3.50 



Format specification is mandatory when opening the device for formatting. 
However, when accessing a floppy disk for other operations (read and 
write), the format specification field can be omitted. In this case, the floppy 
disk driver will automatically determine the format previously established 
on the diskette and then perform the requested operation (for example, epic 
-itv</dev/rsdk/fl). 

The last parameter, t or u, selects the partition to be accessed, t represents 
the whole diskette. Without t or u specified, the whole diskette except 
cylinder will be selected, u represents the whole diskette except track of 
cylinder 0. 

Besides the device file naming convention described above, some of the for- 
mats have alias names that correlate to previous releases. The following list 
describes the formats that have an alias: 



format alias 

5h ql5d 

5d8 d8d 

5d9 d9d 



For example, the device file /dev/rdsk/f0ql5dt is equivalent to 
/dev/rdsk/£05ht. 
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In order to minimize errors when using diskettes, the driver attempts to 
assure that the diskette is installed when needed, and that the operations 
requested have been completed before the device close is completed. In 
particular, the drive is checked for the presence of a diskette each time a 
read/write request is made to the drive. If this is not true (either the 
diskette is not physically present or the door is open), the driver retries the 
request continually, at five-second intervals. The message: 

FD(«): diskette not present - please insert 

appears after each attempt (the n represents the drive number). The INTR 
and QUIT signals are honored in this case, so that the process accessing the 
diskette drive in question will receive these signals (unless, of course, the 
process itself is ignoring them). In particular, if the diskette is removed 
prematurely, or not inserted soon enough, no data is lost provided the 
correct diskette is inserted in the drive when the message to do so is 
displayed. 

loctl Calls 

V_GETPARMS 

This call is used to get information about the current drive confi- 
guration. The argument to the ioctl is the address of one of the fol- 
lowing structures, defined in <sys/vtoc.h>, which will be filled in 
by the ioctl: 

struct disk—parms { 

char dp_type; 
unchar dp_heads; 
ushort dp_cyls; 
unchar dp_sectors; 
ushort dp— secsiz; 



V 



} 



ushort 
ushort 
ushort 
ushort 



dp^ptag; 
dp_pflag; 
dp_pstartsec; 
dp_pnumsec; 



/* Disk type (see below) 
/* Number of heads */ 
/* Number of cylinders */ 
/* Number of sectors/track 
/* Number of bytes/sector ' 

/* for this partition: */ 
/* Partition tag (not used) */ 
/* Partition flag (not used) */ 
/* Starting sector number */ 
/* Number of sectors */ 



V 
V 



/* Disk types */ 

#define DPT_WINI 1 /* Winchester disk */ 

#define DPT_FLOPPY 2 /* Floppy */ 

#define DPT_OTHER 3 /* Other type of disk */ 

#define DPT_NOTDISK /* Not a disk device */ 

For the floppy driver, the disk type will always be DPT_FLOPPY. 
The unused fields in the disk__parms structure are only applicable to 
hard disks; however, returning the same structure from both the 
hard disk driver and the diskette driver allows programs to be writ- 
ten that can understand either one. 

V_FORMAT 

This call is used to format tracks on a diskette. The argument 
passed to the ioctl is the address of one of the following structures. 
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defined in <sys/vtoc.h>, containing the starting track, number of 
tracks, and interleave factor: 

union io_arg { 
struct { 

ushort start_trk; /* first track */ 

ushort num_-trks; /* number of tracks 

to format */ 
ushort intlv; /* interleave factor */ 

} ia_fmt; 

} 

Formatting will start at the given track and will continue so that the 
given number of tracks are formatted, using the given interleave fac- 
tor. 

Note that the file descriptor must refer to the character (raw) special 
device for the desired drive, and the file must have been opened in 
exclusive mode (i.e., 0_EXCL). 

FILES 

/dev/dsk/fO, /dev/rdsk/fO, ... 
/dev/dsk/fOt, /dev/rdsk/fOt, ... 
/dev/dsk/f05h, /dev/rdsk/f05h, ... 
/dev/dsk/f05ht, /dev/rdsk/f05ht, ... 
/dev/dsk/f05d9, /dev/rdsk/f05d9, ... 
/dev/dsk/f05d9t, /dev/rdsk/f05d9t, ... 
/dev/dsk/fOfd8, /dev/rdsk/f05d8, ... 
/dev/dsk/f05d8t, /dev/rdsk/f05d8t, ... 
/dev/dsk/f05d4, /dev/rdsk/f05d4, ... 
/dev/dsk/f05d4t, /dev/rdsk/f05d4t, ... 
/dev/dsk/f05dl6, /dev/rdsk/f05dl6, ... 
/dev/dsk/f05dl6t, /dev/rdsk/f05dl6t, ... 
/dev/dsk/f05q, /dev/rdsk/f05q, ... 
/dev/dsk/f05qt, /dev/rdsk/f05qt, ... 
/dev/dsk/f03h, /dev/rdsk/f03h, ... 
/dev/dsk/f03ht, /dev/rdsk/f03ht, ... 
/dev/dsk/f03d, /dev/rdsk/f03d, ... 
/dev/dsk/f03dt, /dev/rdsk/f03dt, ... 

SEE ALSO 

format(l), mkpart(lM), ioctl(2), hd(7). 

DIAGNOSTICS 

The driver will retry failed transfers up to ten times. If the request still has 
not succeeded, the driver will display an appropriate message. Errors from 
the diskette controller, other than the above, are displayed as follows: 

FD drv n, blk h: drive error message 
FD controller controller error message 

The first message occurs on an error after a transfer has begun, where n is 
the drive where the error occurred, and b is the block number that is being 
read or written. The drive error message is one of the messages appearing in 
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the following list: 

Missing data address mark 

The diskette may not be formatted properly. 

Cylinder marked bad 

The accessed cylinder has been marked bad by the formatter. 

Seek error (wrong cylinder) 

The drive positioned itself at the wrong cylinder when attempting to 
set up for the requested transfer. 

Uncorrectable data read error 

A CRC error was detected when attempting to read the requested 
block from the drive. 

Sector marked bad 

The accessed sector has been marked bad by the formatter. 

Missing header address mark 

The diskette may not be formatted properly. 

Write protected 

A write was attempted to a diskette that is currently write-protected. 

Sector not found 

The diskette may not be formatted properly. 

Data overrun 

The system could not keep up with the requested transfer of data. 
(Should not occur.) 

Header read error 

The diskette may not be formatted properly. 

Illegal sector specified 

The driver is confused about the format of the diskette that has 
been inserted. (Should not occur.) 

The second message occurs when there is a controller error during the setup 
for, or actual transfer of, a block. The controller error message is one of the 
messages appearing in the following list: 

command timeout 

The controller failed to complete the requested command in a rea- 
sonable length of time. 

status timeout 

The controller failed to return its status after a command was com- 
pleted. 

busy During an attempt to access the controller, a timeout occurred. 
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NAME 

hd - hard (fixed) disk 
DESCRIPTION 

The hard disk driver supports an IBM disk controller. It can handle up to 
two hard disk drives with one diskette drive, or one hard disk drive with 
two diskette drives. The drive characteristics are read from the CMOS RAM 
at boot time; these characteristics are defined during system setup by using 
the setup program on the AT Diagnostics diskette. The driver determines 
the layout of the disk dynamically, as described below. It provides block 
and character (raw) access to the individual partitions of the disk, as well as 
the entire physical disk. 

The minor device number of the device being accessed determines how the 
drive is treated: the low-order 4 bits determine the partition (0 — 15), and 
the fifth bit determines the drive number (0 or 1). Partition represents the 
entire UNIX system partition (as defined by the fdisk table). Other parti- 
tions are defined by information in the volume table of contents (VTOC). 
When accessing partition 0, other partition boundaries are ignored, and no 
bad block mapping occurs. Thus, the user must take care when using the 
disk in this way. 

The full fixed disk is partitioned at two levels: first, sections of the disk to 
be used by different operating systems are described by the fdisk table con- 
tained in the first block of the disk. Second, the UNIX system sections of 
the disk are further partitioned according to information contained in the 
VTOC, which may be located in any block. [The VTOC is currently in the 
30th sector of the UNIX system partition.] block on the second track of the 
disk; see mkpart{lM).] The VTOC also contains information about the non- 
UNIX system partitions described in the fdisk table. When the disk device is 
opened, the VTOC is read by the driver and is used to fill out its tables of 
logical disks, assigned by minor device number. 

Each partition in the fdisk table is specified as to its type (e.g., DOS, UNIX 
system, or other). A partition (file system) is usable by the UNIX system 
only if its type is correct (e.g., a DOS partition is not usable by the UNIX 
system, except as a raw, non-file system device.) 

On each drive, sector contains the primary bootstrap and the fdisk table. 
The first 29 sectors of the UNIX system partition contain the first-stage and 
second-stage bootstraps. The 30th sector contains the pdinfo and VTOC 
table. Sectors 31-34 contain the bad block and track mapping tables. As 
many sectors as needed, beginning with the 35th sector, are used for alter- 
nate tracks and sectors. 

The fdisk table indicates which of the partitions is the 'active', or bootable, 
partition. When the machine is booted, the primary boot code looks in the 
fdisk table for the active partition and jumps to sector of that partition to 
find the first-stage bootstrap. If the first-stage bootstrap is over one sector 
in length, it is the responsibility of the first-stage bootstrap to understand 
this. Note that both the first cylinder (containing the fdisk table, first-stage 
bootstrap, VTOC, and alternate sectors) and the first track of the active par- 
tition (containing the first-stage bootstrap) can only be accessed using 
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partition 0, since these tracks are normally not considered part of any other 
partition in the VTOC. 

Bad sectors are mapped out by the driver as follows: The bad block map is 
read by the driver when the drive is first opened. The map is an array of 
pairs of numbers, representing a bad sector and its assigned alternate, each 
entry being an absolute sector number, starting with for the first sector of 
the disk. 

Before each I/O operation, the driver looks through the map to determine if 
any sector in the requested transfer is bad. If there is a bad sector within 
the request, all the I/O up to the bad sector is done, then the bad sector is 
remapped, and finally the I/O following the bad sector is done. 

Note that this scheme requires running mkpart(lM) before bringing up the 
system from the hard disk for the first time. The mkpart program will 
attempt to optionally write and then read every sector on the disk, looking 
for sectors where this operation fails. All bad sectors will be placed in alter- 
nates map, which is built by mkpart and installed on the disk at the same 
time that the VTOC is installed. If this verification pass is not done, how- 
ever, the system v^l still work. Since the driver will notice that the table is 
empty, it will not attempt to map bad sectors. 

In the event that a disk develops bad blocks once the system is running, 
mkpart may run (with the -A option) to add the new bad blocks to the map. 
However, the user may have to restore the file system from the last full 
dump, depending on where the bad block occurred. 

loctl Calls 

V_CONFIG 

This call is used by mkpart to reconfigure the drive, so that the drive 
configuration matches the parameters specified in the 
/etc/partitions file. This is useful because the disk type read from 
the CMOS RAM is limited to one of 23 tj^es defined in a table in 
the system BIOS. If the disk installed on the system does not 
exactiy match one of the table entries, the machine is set up using 
the closest table entry, and mkpart will tell the driver the true disk 
parameters (as defined by the /etc/partitions file) by using the 
V_CONFIG iocti. The argument to the ioctl is the address of one of 
the following structures, defined in <sys/vtoc.h>, containing the 
new configuration parameters: 

union io_arg { 
struct { 

ushort ncyl; /* number of cylinders */ 
unchar nhead; /* heads/cylinder */ 
unchar nsec; /* sectors/track */ 
ushort secsiz; /* bytes/sector */ 

} ia_cd; 

} 

Note that it is not possible to change the sector size on the hard 
disk, and that an attempt to do so will result in the iocti failing, 
with errno set to EINVAL. 
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VJ^EMOUNT 

This call is used to force the driver to re-read the VTOC on the next 
open of the drive. It will fail if any partition other than partition 
is currently open, since changing the partition table information is 
potentially disastrous for a process using the partition. This is used 
by mkpart when it changes the VTOC, so that the driver will update 
its internal tables. 

V_ADDBAD 

This call is used to tell the driver about a bad sector. If the new 
bad sector is an assigned alternate, the ioctl fails with errno set to 
EINVAL; if it is an unassigned alternate, it is removed from the 
alternates map; if neither of these is true, it is assigned an alternate 
and added to the map. The argument to the ioctl is the address of 
one of the following structures, defined in <sys/vtoc.h>, with the 
first two fields filled in; the third field is filled in by the ioctl and 
returned to the user: 



union io-_arg { 
struct { 



ushort flags; 
daddr_t bad_sector; 
daddr— t new_sector; 



} 



} ia_abs; 



/* currently not used */ 
/* bad sector number */ 
/* RETURNED alternate 
assigned */ 



V_GETPARMS 

This call is used to get information about the current drive confi- 
guration. The argument to the ioctl is the address of one of the fol- 
lowing structures, defined in <sy8/vtoc.h>, which will be filled in 
by the ioctl: 



struct disk_parms { 



char 
unchar 
ushort 
unchar 
ushort 
ushort 
ushort 

daddr_t dp_pstartsec; 
daddr_t dp_pnumsec; 



dp_type; 
dp_heads; 
dp—cyls; 
dp_sectors; 
dp_secsiz; 
dp_ptag; 
dp_pflag; 



/* Disk type (see below) 
/* Number of heads */ 
/* Number of cylinders */ 
/* Number of sectors/track */ 
/* Number of bytes/sector */ 

/* Partition tag */ 

/* Partition flag */ 
/* Starting absolute sector 

number */ 
/* Number of sectors */ 



/* Disk types */ 
#define DPT_WINI 1 
#define DPT_FLOPPY 2 
#define DPT_OTHER 3 
#define DPT_NOTDISK 



/* Winchester disk */ 
/* Floppy */ 
/* Other type of disk */ 
/* Not a disk device */ 
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/* Partition tag */ 
#define V_BOOT 
#define V_JlOOT 
#define V_SWAP 
#define V_USR 
#define V_BACKUP 
#define V_ALTS 
#define V_OTHER 

/* Partition flag */ 
#define V_UNMNT 
#define V_RONLY 
#define V_OPEN 
#define V_VALID 



1 /* bootable partition */ 

2 /* root filesystem */ 

3 /* swap filesystem */ 

4 /* usr filesystem */ 

5 /* entire disk */ 

6 /* alternate sectors */ 

7 /* non-UNIX system partition */ 



0x001 /* unmountable partition */ 
0x010 /* read only partition */ 

0x100 /* partition open */ 
0x200 /* partition valid to use */ 

For the hard disk driver, the disk type will always be DPT_WINI. 
Since the structure returned by V_GETPARMS is the same for both 
the diskette and hard disk drivers, programs may be written to 
understand either one. 

V_FORMAT 

This call is used to format tracks on a disk. The argument passed to 
the ioctl is the address of one of the following structures, defined in 
<sys/vtoc.h>, containing the starting track, number of tracks, and 
interleave factor: 



union io— arg { 
struct { 



} 



} ia_fmt; 



ushort start_trk; 
ushort num_trks; 

ushort intlv; 



/* first track */ 
/* number of tracks 
to format */ 
/* interleave factor */ 



Note that the file descriptor argument to the ioctl must refer to the 
character (raw) special device for the desired drive, and the file must 
have been opened in exclusive mode (i.e., 0_EXCL). 

GETALTTBL 

This call returns the four pieces of alternates information. The four 
pieces are the sanity value, the version number, the bad track table, 
and the bad sector. The alt_info structure is defined in 
<sys/alttbl.h>. 



struct alt_info { 

long alt_sanity; 
ushort alt_version; 
ushort alt_pad; 
struct alt_table alt_trk; 
struct alt_table alt__sec; 

}; 



/* table length should be multiple of 512 */ 

/* to validate correctness */ 
/* to corroborate vintage */ 
/* padding for alignment */ 
/* bad track table */ 
/* bad sector table */ 
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V_VERIFY 

This call has a dual purpose. Its primary role is to do a read verify 
of any portion of the disk. The desired start sector is placed in 
abs_sec, and the desired number of sectors is placed in num_sec. If 
an error occurs it is placed in err_code. The other purpose of the 
routine is to do timings of the read verify. This task is accomplised 
by setting the time_flg. The time required to do the verify is then 
placed in delta time. The vfy_io structure is defined in 
<sys/vtoc.h>. 
union vfy_Jo { 
struct { 

daddr_t abs_sec; /* absolute sector number */ 
ushort num_sec; /* number of sectors to verify */ 
ushort time_flg; /* flag to time the operation */ 

}vfy_in; 
struct { 

time— t deltatime; /* duration of operation */ 

ushort err_code; /* reason for failure */ 
}vfy_out; 

}; 

V_PDLOC 

This call simply returns the logical sector address of the PDinfo 
structure. The value is returned in pdloc. 

unsigned long pdloc; 
V_RDABS 

This call is used as a method of reading any sector on the hard disk. 
Only users with root privilege can freely access any sector. Users 
who do not have root privilege can access the partition table (sector 
0) or the boot slice (to allow access to the vtoc). The logical sector 
address is placed abs_sec. The 512 bytes of sector information are 
returned in abs_buf. The absio structure is defined in 
<sys/vtoc.h>. 

struct absio { 

daddr_t abs_sec; /* Absolute sector number (from 0) */ 

char *abs_buf; /* Sector buffer */ 

}; 

V_WRABS 

This call is used to write 512 bytes to any sector on the disk. Only 
users with root privilege can make use of the call. The logical sector 
location to be written to is placed in abs_sec. The 512 bytes of data 
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to be written are placed in abs_buf . The absio structure is defined in 

<sys/vtoc.h>. 

struct absio { 

daddr_t abs_sec; /* Absolute sector number (from 0) */ 

char *abs-_buf; /* Sector buffer */ 

}; 

Partitions 

The fdisk table allows partitions to be assigned at cylinder boundaries; how- 
ever, the VTOC will allow partitions to start on track boundaries. This is 
used in the bootable UNIX system partition to make the first track (contain- 
ing the bootstrap code) not be an actual part of the partition. The fdisk table 
allows at most four partitions on a fixed disk, but the VTOC allows the 
UNIX system portion to be divided into at most 16 partitions. Each parti- 
tion is identified by a minor device number; the mapping from partition to 
minor device number is made at the time the disk is first accessed, and is 
determined by the /etc/partitions file. This mapping will remain the same 
until the /etc/partitions file is changed and the mkpart program rerun. 

Attempts to open file systems for which there are no partitions will fail 
(non-existent device). Likewise, attempts to mount [see mount (8)] partitions 
that do not contain UNIX file systems will fail. 

FILES 

/dev/dsk/OsO, ... 
/dev/rdsk/OsO, ... 

SEE ALSO 

fdisk(lM), mkpart(lM), ioctl(2), fs(4), fd(7). 
DIAGNOSTICS 

The driver will retry failed transfers up to ten times depending on the error 
type. Certain errors are not retried. The driver will display an appropriate 
message upon encountering an error during the transfer. Error types that 
are retried are indicated in the table below. Errors from the fixed disk con- 
troller are displayed as follows: 

HD error: drive n, cyl c, head h, sector s: drive error message 
HD controller: controller error message 

The first message occurs on an error after a transfer has begun, where n is 
the drive where the error occurred, c is the cylinder, h is the head, and s is 
the sector being read or written. The drive error message is one of the mes- 
sages appearing in the following list: 

Track not found 

The disk may not be formatted properly. 

Uncorrectable data read error 

The controller detected a CRC error when attempting to read the 
requested block. 

Data address mark not found 

The disk may not be formatted properly. 



-6- 



HD(7) 



HD{7) 



Sector not found 

The disk may not be formatted properly. 

Command aborted 

The controller did not complete execution of a command. 

Bad track flag detected 

The block requested has been marked bad, but does not appear in 
the bad block map. 

The second message occurs when there is a controller error during the setup 
for, or actual transfer of, a block. The controller error message is one of the 
messages appearing in the following list: 

command aborted 

The controller failed to complete the requested command. 

write fault 

The controller detected some error on the hard disk drive. 
stays busy 

During an attempt to access the controller, a timeout occurred. 
There is one additional message which indicates a controller-corrected error 
occurred: 

NOTE: Soft read error corrected by ECC algorithm: unit n, sector s 

where n is the drive where the error occurred, and s is the sector being read. 
This warning indicates that the controller's error-correction algorithm suc- 
cessfully recovered from an error. This may be a symptom of a sector going 
bad. If this message appears several times for the same sector, that sector 
should probably be marked bad. 

WARNINGS 

The VTOC and alternate sector mapping scheme requires that no bad sec- 
tors occur in cylinder 0. The mkpart program will issue a fatal error mes- 
sage when it attempts to configure a drive where there are bad sectors in 
the first cylinder. Also, since the second-stage bootstrap must be installed 
on the first track of the bootable partition, this track must also contain no 
bad sectors. 
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NAME 

keyboard - system console keyboard 
DESCRIPTION 

The system console is composed of two separate pieces: the keyboard and 
the display [see display (7)]. 

The keyboard is used to type data, and send certain control signals to the 
computer. UNIX software performs terminal emulation on the console 
screen and keyboard, and, in doing so, makes use of several particular keys 
and key combinations. These keys and key combinations have special 
names that are unique to the UNIX system, and may or may not correspond 
to the keytop labels on your keyboard. 

When you press a key, one of the following happens: 

- An ASCII value is entered 

- The meaning of another key, or keys, is changed. 

- A string is sent to the computer. 

- A function is initiated. 

When a key is pressed (a keystroke), the keyboard sends a scancode to the 
computer. This scancode is interpreted by the keyboard driver. The actual 
code sequence delivered to the terminal input routine [see termio{7)] is 
defined by a set of internal tables in the driver. These tables can be modi- 
fied by software (see the discussion of ioctl calls below). In addition, the 
driver can be instructed not to do translations, delivering the keyboard 
up/down scan codes directly. 

Changing Meanings 

The action performed by a key can be changed by using certain keys in 
combination. For example, the SHIFT key changes the ASCII values of the 
alphanumeric keys. Holding down the CTRL key while pressing another 
key sends a control code (such as CTRL-D, CTRL-S, and CTRL-Q). Holding 
down the ALT key also modifies a key's value. The SHIFT, CTRL, and 
ALT keys can be used in combination. 

Switching Screens 

To switch the current screen, type ALT-SYSREQ (also labelled ALT- 
PRINTSCRN on some systems) followed by a key which identifies the 
desired screen. Any active screen may be selected by following ALT- 
SYSREQ with Fn, where Fn is one of the function keys. Fl refers to the 
first virtual terminal screen, F2 refers to the second virtual terminal screen, 
etc. ALT-SYSREQ 'h' refers to the main console display (/dev/console). 
The next active screen can be selected with ALT-SYSREQ 'n,' and the previ- 
ous screen can be selected with ALT-SYSREQ 'p.' 

The default screen switch enable sequence (ALT-SYSREQ) is configurable. 
The SYSREQ table entry can be modified by software (see discussion of 
IOCTL calls below). 
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Special Keys 

The following table shows which keys on a typical console correspond to 
UNIX system keys. In this table, a hyphen (-) between keys means you 
must hold down the first key while pressing the second. The mapping 
between characters which generate signals and the signal actually generated 
is set with stty(l), and may be changed [see stty(l)]. 
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Name 

INTR 

BACKSPACE 

CTRL-D 
CTRL-H 
CTRL-Q 
CTRL-S 
CTRL-U 
CTRL-\ 
ESCAPE 

RETURN 
Fn 



Keytop 

DEL 



CTRL-D 
CTRL-H 
CTRL-Q 
CTRL-S 
CTRL-U 
CTRL-\ 
ESC 



(down-left arrow 
or ENTER) 

Fn 



Action 

Stops current action and returns to the shelL This 
key is also called the RUB OUT or INTERRUPT key. 

Deletes the first character to the left of the cursor. 
Note that the "cursor left" key also has a left arrow 
(-»-) on its keytop, but you cannot backspace using 
that key. 

Signals the end of input from the keyboard; also 
exits current shell. 

Deletes the first character to the left of the cursor. 
Also called the ERASE key. 

Restarts printing after it has been stopped with 
CTRL-S. 

Suspends printing on the screen (does not stop the 
program). 

Deletes all characters on the current line. Also 
called the KILL key. 

Quits current command and creates a core 

file, if allowed. (Recommended for debugging only.) 

Special code for some programs. For example, 
changes from insert mode to command mode in the 
vi{l) text editor. 

Terminates a command line and initiates an action 
from the shell. 

Function key n. F1-F12 are unshifted, F13-F24 are 
shifted F1-F12, F25-F36 are CTRL-Fl through F12, 
and F37-F48 are CTRL-SHIFT-Fl through F12. 

The next Fn keys (F49-F60) are on the number pad 
(unshifted): 



F49 - 


7' 


F55 - 


'6' 


F50 - 


'8' 


F56 - 




F51 - 


'9' 


F57 - 


'1' 


F52 - 




F58 - 


'2' 


F53 - 


'4' 


F59 - 


'3' 


F54 - 


'5' 


F60 - 


'0' 
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Keyboard Map 

The keyboard mapping structure is defined in /usr/include/sys/kd.h. 
Each key can have ten states. The first eight states are: 

- BASE - CTRL-SHIFT 

- SHIFT - ALT-SHIFT 

- CTRL - ALT-CTRL 

- ALT - ALT-CTRL-SHIFT 

The two remaining states are indicated by two special bytes. The first byte 
is a "special state" byte whose bits indicate whether the key is "special" in 
one or more of the first eight states. The second byte is one of four codes 
represented by the characters C, N, B, or O which indicate how the lock 
keys affect the particular key. 

The following table describes the default keyboard mapping. All values, 
except for special keywords (which are described later), are ASCII character 
values. 

Heading Description 

SCAN CODE This column contains the scan code generated by the key- 
board hardware when a key is pressed. There are no table 
entries for the scan code generated by releasing a key. 

BASE This column contains the normal value of a key press. 

SHIFT This column contains the value of a key press when the 

SHIFT is also being held down. 
LOCK This column indicates which lock keys affect that particular 

key: 

- C indicates CAPSLOCK 

- N indicates NUMLOCK 

- B indicates both 

- O indicates locking is off 

The remaining columns are the values of key presses when combinations of 
the CTRL, ALT and SHIFT keys are also held down. 

The SRQTAB column entry is included in this table to provide a simple 
index of the default virtual terminal key selectors to the scan code to which 
it is assigned. The actual SRQTAB table is a stand-alone table which can be 
read or written via the KDGKBENT and KDSKBENT lOCTL calls. 
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SCAN 
CODE 


BASE 


SHIFT 


CTRL 


CTRL 
SHIFT 


ALT 


ALT 
SHIFT 


ALT 
CTRL 


ALT 

CTRL 

SHIFT 


LOCK 


SRQTAB 







nop 


nop 


nop 


nop 


nop 


nop 


nop ■ 


o 


nop 


1 


esc 


esc 


esc 


esc 


esc 


esc 


esc 


esc 


o 


nop 


2 


'1' 


'!' 


'1' 


'1' 


escn 


escn 


nop 


nop 

r 


o 


nop 


3 


'2' 


'@' 


'2' 


nul 


escn 


escn 


nop 


nop 


o 


nop 


4 


'3' 


'#' 


'3' 


'3' 


escn 


escn 


nop 


nop 


o 


nop 


5 


'4' 




'4' 


'4' 






nop 


nop 


o 


nop 




'5' 


/o 


'5' 


'5' 










Q 




7 


'6' 




'6' 


rs 


escn 


escn 


nop 


nop 


o 


nop 


8 


'7' 


'&' 


'7' 


'7' 


escn 


escn 


nop 


nop 


o 


nop 


9 


'8' 




'8' 


'8' 


escn 


escn 






o 




10 


'9' 


V 


'9' 


'9' 


escn 


escn 


nop 


nop 


o 


nop 


11 


'0' 




'0' 


'0' 


escn 


escn 


nop 


nop 


o 


nop 


12 


















o 


nop 


13 






,_, 








nop 


nop 


o 


nop 


14 


bs 


bs 


bs 


bs 


bs 


bs 


bs 


bs 


o 


nop 


15 


ht 


btab 


ht 


btab 


ht 


btab 


ht 


btab 


o 


nop 


16 




'O' 


del 


del 










Q 


nop 


17 


'w' 


'W 


etb 


etb 


escn 


escn 


nop 


nop 


c 


nop 


18 


'e' 


'E' 


enq 


enq 


escn 


escn 


nop 


nop 


c 


nop 


19 




'R' 




acz 


escn 


escn 


nop 


nop 




nop 


20 


't' 


/J/ 


dc4 


dc4 


escn 


escn 


nop 


nop 




nop 


21 


'v' 


'Y' 


en\ 


em 






nop 


nop 


Q 


nop 


22 


'u' 


'U' 


nak 


nak 






nop 


nop 


Q 


nop 


23 




'I' 


ht 


ht 






nop 


nop 


Q 


nop 


24 


'o' 


'O' 










nop 


nop 


c 


nop 


25 


'd' 

r 


'P' 


die 


die 


escn 


escn 


nop 


nop 


Q 


K__PREV 


26 


T' 










escn 


nop 


nop 




nop 


27 


'1' 
J 






nop 






cr°^ 


cr°^ 


o 


nop 


28 


cr 


cr 


cr 


cr 


cr 


cr 






o 


nop 


29 


Ictrl 


Ictrl 


Ictrl 


Ictrl 


Ictrl 


Ictrl 


Ictrl 


Ictrl 


o 


nop 


30 




'A' 










nop 


nop 


Q 


nop 


31 


's' 


'S' 


dc3 


dc3 






nop 


nop 


Q 


nop 


32 


'd' 


'D' 






escn 


escn 


nop 


nop 


c 


nop 


HQ 


'(' 
I 


'C 

r 


ack 


^ -,1, 
acK 


escn 


escn 


nop 


nop 


C 


K_FKCNEXT 


^4 


'g' 


Vj 


Del 


Dei 


escn 


escn 


nop 


nop 


C 


nop 


35 


'h' 


'H' 


bs 


bs 


escn 


escn 


nop 


nop 


C 


K_VTF 


36 


T 


'J' 


nl 


nl 


escn 


escn 


nop 


nop 


C 


nop 


37 


'k' 


'K' 


vt 


vt 


escn 


escn 


nop 


nop 


C 


nop 


38 


'1' 


'L' 


np 


np 


escn 


escn 


nop 


nop 


C 


nop 


39 










escn 


escn 


nop 


nop 


o 


nop 


40 




' M ' 






escn 


escn 


nop 


nop 


o 


nop 


41 










escn 


escn 


nop 


nop 


o 


nop 


42 


Ishift 


Ishift 


Ishift 


Ishift 


Ishift 


Ishift 


Ishift 


Ishift 


o 


nop 


43 


'W 


'1' 


fs 


T 


escn 


escn 


nop 


nop 


o 


nop 
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SCAN 
CODE 


BASE 


SHIFT 


CTRL 


CTRL 
anlr i 


ATT 


ATX 


ATX 
L 1 l\Li 


ATX 

r'XRI 
\- 1 IVLi 


LOCK 




44 


'z' 


'Z' 


sub 


sub 


escn 


escn 


nop 


nop 


C 


nop 


45 


'x' 


'X' 


can 


can 


escn 


escn 


nop 


nop 


C 


nop 


46 


'c' 


'C 


etx 


etx 


escn 


escn 


nop 


nop 


C 


nop 


47 


'v' 


'V 


syn 


syn 


escn 


escn 


nop 


nop 


C 


nop 


48 


'b' 


'B' 


stx 


stx 


escn 


escn 


nop 


nop 


C 


nop 


49 


'n' 


'N' 


so 


so 


escn 


escn 


nop 


nop 


C 


K_NEXT 


50 


'm' 


'M' 


cr 


cr 


escn 


escn 


nop 


nop 


C 


nop 


51 


'/ 


'<' 




'<' 


escn 


escn 


nop 


nop 


o 


nop 


52 


'/ 


'>' 




'>' 


escn 


escn 


nop 


nop 


o 


nop 


53 


7' 


'?' 


7' 


ns 


escn 


escn 


nop 


nop 


o 


nop 


54 


rshift 


rshift 


rshift 


rshift 


rshift 


rshift 


rshift 


rshift 


o 


nop 


55 


'*' 






'*' 


escn 


escn 


nop 


nop 


o 


nop 


56 


lalt 


lalt 


lalt 


lalt 


lalt 


lalt 


lalt 


lalt 


o 


nop 


57 






nul 


nul 


escn 


escn 


nop 


nop 


o 


nop 


58 


clock 


clock 


clock 


clock 


clock 


clock 


clock 


clock 


o 


nop 


59 


fkeyl 


fkeyl 3 


fkey25 


fkey37 


fkeyl 


fkeyl 3 


fkey25 


fkey37 


o 


K_VTF+1 


60 


fkey2 


fkeyl 4 


fkey26 


fkey38 


fkey2 


fkeyl 4 


fkey26 


fkey38 


o 


K_VTF+2 


61 


fkey3 


fkeyl 5 


fkey27 


fkey39 


fkey3 


fkeyl 5 


fkey27 


fkey39 


o 


K_VTF+3 


62 


fkey4 


fkeyl 6 


fkey28 


fkey40 


fkey4 


fkeyl 6 


fkey28 


fkey40 


o 


K_VTF4-4 


63 


fkey5 


fkeyl 7 


fkey29 


fkey41 


fkeyS 


fkeyl 7 


fkey29 


fkey41 


o 


K_VTF+5 


64 


fkey6 


fkeyl 8 


fkey30 


fkey42 


fkey6 


fkeyl 8 


fkey30 


fkey42 


o 


K_VTF+6 


65 


fkey7 


fkeyl 9 


fkey31 


fkey43 


fkey7 


fkeyl 9 


fkey31 


fkey43 


o 


K_VTF+7 


66 


fkey8 


fkey20 


fkey32 


fkey44 


fkey8 


fkey20 


fkey32 


fkey44 


o 


K_VTF+8 


67 


fkey9 


fkey21 


fkey33 


fkey45 


fkey9 


fkey21 


fkey33 


fkey45 


o 


K_VTF+9 


68 


fkeylO 


fkey22 


fkey34 


fkey46 


fkeylO 


fkey22 


fkey34 


fkey46 


o 


K_VTF+10 


69 


nlock 


nlock 


nlock 


nlock 


nlock 


nlock 


nlock 


nlock 


o 




70 


slock 


slock 


brk 


brk 


slock 


slock 


brk 


brk 


o 




71 


fkey49 


'T 


fkey49 


'T 


fkey49 


escn 


nop 


nop 


N 




72 


fkey50 




fkey50 


'8' 


fkey50 


escn 


nop 


nop 


N 




73 


fkey51 


'9' 


fkeySl 


'9' 


fkey51 


escn 


nop 


nop 


N 




74 


fkey52 


'_' 


fkey52 


'-' 


fkey52 


escn 


nop 


nop 


N 




75 


fkey53 


'4' 


fkey53 


'4' 


fkey53 


escn 


nop 


nop 


N 




76 


fkey54 


'5' 


fkey54 


'5' 


fkey54 


escn 


nop 


nop 


N 




77 


fkey55 


'6' 


fkey55 


'6' 


fkey55 


escn 


nop 


nop 


N 




78 


fkey56 




fkey56 


'+' 


fkey56 


escn 


nop 


nop 


N 




79 


fkey57 


'1' 


fkey57 


'1' 


fkey57 


escn 


nop 


nop 


N 




80 


fkey58 


'2' 


fkey58 


'2' 


fkey58 


escn 


nop 


nop 


N 




81 


fkey59 


'3' 


fkey59 


'3' 


fkey59 


escn 


nop 


nop 


N 




82 


fkey60 


'0' 


fkey60 


'0' 


fkey60 


escn 


nop 


nop 


N 




83 


del 




del 




del 


escn 


rboot 


nop 


N 




84 


fkey60 


fkey26 


fkey60 


nop 


sysreq 


sysreq 


sysreq 


sysreq 


O 




85 


fkey58 


fkey58 


fkey58 


fkey58 


fkey58 


fkey58 


fkey58 


fkey58 


O 




86 


fkey53 


fkey53 


fkey53 


fkey53 


fkey53 


fkey53 


fkey53 


fkey53 


o 




87 


fkeyl 1 


fkey23 


fkey35 


fkey47 


fkeyl 1 


fkey23 


fkey35 


fkey47 


o 


K_VTF4-11 


88 


fkeyl 2 


fkev24 


fkev36 


fkev48 


fkeyl 2 


fkey24 


fkey36 


fkey48 


o 


K_VTF+12 
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SCAN 
CODE 


BASE 


SHIFT 


CTRL 


CTRL 
SHIFT 


ALT 


ALT 
SHIFT 


ALT 
CTRL 


ALT 

CTRL 

SHIFT 


LOCK 


SRQTAB 


89 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


O 


K_NOP 


90 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


91 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


92 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


93 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


94 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


95 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


96 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


97 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


98 


hop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


99 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


100 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


101 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


102 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


103 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


104 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


105 


nop 


nop 


nop 

r 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


106 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


107 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


108 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


109 


nop 


nop 


nop 


nop 


nop 


nop 


nop 

r 


nop 


o 


K_NOP 


110 


nop 


nop 


nop 

r 


nop 


nop 


nop 


nop 


nop 


o 


K__NOP 


111 


fkeySl 


fkey51 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


112 


nop 


nop 

r 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K NOP 


113 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


114 


rait 


rait 


rait 


rait 


rait 


rait 


rait 


rait 


o 


K_NOP 


115 


rctrl 


rctrl 


rctrl 


rctrl 


rctrl 


rctrl 


rctrl 


rctrl 


o 


K_NOP 


116 


cr 


cr 


cr 


cr 


cr 


cr 


cr 


cr 


o 


K_NOP 


117 


'/' 


'/' 


nop 


nop 


escn 


escn 


nop 


nop 


o 


K_NOP 


118 


nop 


nop 

Jr 


nop 


nop 


nop 

r 


nop 


nop 


nop 


o 


K_NOP 


119 


brk 


brk 


brk 


brk 


brk 


brk 


brk 


brk 


o 


K_NOP 


120 


fkey50 


fkey50 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


121 


del 


del 


del 


del 


del 


del 


del 


del 


o 


K_NOP 


122 


fkey57 


fkey57 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


123 


fkey60 


fkey60 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


124 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


125 


fkey55 


fkey55 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


126 


fkey59 


fkey59 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 


127 


fkey49 


fkey49 


nop 


nop 


nop 


nop 


nop 


nop 


o 


K_NOP 



The following table lists the value of each of the special keywords used in 
the preceding tables. The keywords are only used in the preceding tables 
for readability. In the actual keyboard map, a special keyword is 
represented by its value vdth the corresponding "special state" bit being set. 
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Name 


Value 


Meaning 


nop 





No operation - no action from keypress 


Ishift 


2 


Left-hand shift 


rshift 


3 


Right-hand shift 


clock 


4 


Caps lock 


nlock 


5 


Numeric lock 


slock 


6 


Scroll lock 


alt 


7 


Alt key 


btab 


8 


Back tab key - generates fixed sequence (ESC[ Z) 


Ctrl 


9 


Control key 


lalt 


10 


Left-hand alt key 


rait 


11 


right-hand alt key 


Ictrl 


12 


Left-hand control key 


rctrl 


13 


Right-hand control key 


fkeyl 


27 


Function key #1 


fkey96 


122 


Function key #96 


svsreq 


123 


System request 


brk 


124 


Break key 


escn 


125 


Generate an ESC N x sequence, where x is the un- 






alt'ed value of the scan code 


esco 


126 


Generate an ESC O x sequence, where x is the un- 






alt'ed value of the scan code 


escl 


127 


Generate an ESC L x sequence, where x is the un- 






alt'ed value of the scan code 


rboot 


128 


Reboot system 


debug 


129 


Invoke kernel debugger 


NEXT 


130 


Switch to next virtual terminal on queue 


PREV 


131 


Switch to previous virtual terminal on queue 


FNEXT 


132 


Forced switch to next virtual terminal on queue 


FPREV 


133 


Forced switch to previous virtual terminal on queue 


VTF 


134 


Virtual Terminal First (VTOO) 


VTL 


148 


Virtual Terminal Last (VT14) 


MGRF 


149 


Virtual Terminal Manager First. Allows assigning 






special significance to key sequence for actions by 






virtual terminal layer manager. Used in SRQTAB 






table. 


MGRL 


179 


Virtual Terminal Manager Last. Used in SRQTAB 






table. 
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The following table lists names and decimal values for ASCII characters in 
the preceding table. Names are used in place of numeric constants to make 
it easier to read the scan code table. Only the decimal values are placed in 
the ioctl buffer. These values are taken from ascii{5). 



Name 


Value 


Name 


Value 


mil 
nui 


U 


UCi 


1 7 
1/ 


son 


1 


UCZ 


1 fi 
lo 


stx 


z 


CiCo 


1 Q 


etx 


3 


dc4 


20 


eot 


4 


nak 


21 


enq 


5 


syn 


22 


ack 


6 


etb 


23 


bel 


7 


can 


24 


bs 


8 


em 


25 


ht 


9 


sub 


26 


nl 


10 


esc 


27 


vt 


11 


fs 


28 


np 


12 


gs 


29 


cr 


13 


rs 


30 


so 


14 


ns 


31 


si 


15 


del 


127 


die 


16 







String Key Mapping 

The string mapping table is an array of 512 bytes (typedef strmap—t) con- 
taining null-terminated strings that redefine the function keys. The first 
null-terminated string is assigned to the first function key, the second string 
is assigned to the second function key, etc. 

There is no limit to the length of any particular string as long as the whole 
table does not exceed 512 bytes, including nulls. To make a string a null, 
add extra null characters. The following table contains default function key 
values. 
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Default Function Key Values 










\^tri 


Function 




btlirt 


Ctrl 


bnirt 


Key w 


Function 


Function 


Function 


Function 


1 


ESC OP 


ESC Op 


ESC OP 


ESC Op 


2 


ESC OQ 


ESC Oq 


ESC OQ 


ESC Oq 


3 


ESC OR 


ESC Or 


ESC OR 


ESC Or 


4 


ESC OS 


ESC Os 


ESC OS 


ESC Os 


5 


ESC OT 


ESC Ot 


ESC OT 


ESC Ot 


6 


ESC OU 


ESC Ou 


ESC OU 


ESC Ou 


7 


ESC OV 


ESC Ov 


ESC OV 


ESC Ov 


8 


ESC OW 


ESC Ow 


ESC OW 


ESC Ow 


9 


ESC OX 


ESC Ox 


ESC OX 


ESC Ox 


10 


ESC OY 


ESC Oy 


ESC OY 


ESC Oy 


11 


ESC OZ 


ESC Oz 


ESC OZ 


ESC Oz 


12 


ESC OA 


ESC Oa 


ESC OA 


ESC Oa 



loctl Calls: 

KDGKBMODE 

This call gets the current keyboard mode. It returns one of the fol- 
lowing values, as defined in /usr/include/sys/kd.h: 

#define K_-RAW 0x00 /* Send row scan codes */ 

#define K_XLATE 0x01 /* Translate to ASCII */ 

KDSKBMODE 

This call sets the keyboard mode. The argument to the call is either 
K__RAW or K-_XLATE. By using raw mode, the program can see 
the raw up/down scan codes from the keyboard. In translate mode, 
the translation tables are used to generate the appropriate character 
code. 

KDGKBTYTE 

This call gets the keyboard type. It returns one of the following 
values, as defined in /usr/include/sys/kd.h: 

#define KB_84 0x00 /*84 key keyboard*/ 

#define KB_101 0x01 /*101 key keyboard*/ 

#define KB_OTHER 0x03 /*Other type keyboard*/ 

KDGKBENT 

This call reads one of the entries in the translation tables. The argu- 
ment to the call is the address of one of the following structures, 
defined in /usr/include/sys/kd.h, with the first two fields filled in: 

struct kbentry { 

unchar kb__table; /* Table to use */ 

unchar kb_Jndex; /* Entry in table */ 

ushort kb_value; /* Value to get/set */ 

}; 

Valid values for the kb— table field are: 



- 10 - 



KEYBOARD(7) 



KEYBOARD(7) 



#define K_NORMTAB 0x00 /♦Base*/ 

#define IC_SHIFTTAB 0x01 /* Shifted */ 

#define K_ALTTAB 0x02 /* Alt */ 

#define IC_ALTSHIFTTAB 0x03 /* Shifted alt */ 

#define K_SRQTAB 0x04 /* Select sysreq 

table V 

The ioctl will get the indicated entry from the indicated table and 
return it in the third field. 

The K-_SRQTAB value for the kb_table field allows access to the 
scancode indexed table which allows assignment of a given virtual 
terminal selector (K_VTF— K_VTL) or the virtual terminal layer 
manager (K_MGRF — K_MGRL) "specialkey" assignments. 

The virtual terminal selector {K_VTF) is normally associated with 
/dev/ttyOO, on which the user login shell is commonly found. The 
following terminal selectors also are used to select virtual terminals: 

K_VTF+1 for the 1st virtual terminal (/dev/vtOl) 
K_VTF+2 for the 2nd virtual terminal (/dev/vt02) 



K__VTF+12 for the 12th virtual terminal (/dev/vtl2) 

KDSKBENT 

This call sets an entry in one of the translation tables. It uses the 
same structure as the KDGKBENT ioctl, but with the third field 
filled in with the value that should be placed in the translation 
table. This can be used to partially or completely remap the key- 
board. 

The kd driver provides support for virtual terminals. The console minor 
device, /dev/vtmon, provides virtual terminal key requests from the kd 
driver to the process that has /dev/vtmon open. Two ioctls are provided 
for virtual terminal support: 

VT_GETSTATE 

The VT— GETSTATE ioctl returns global virtual terminal state infor- 
mation. It returns the active virtual terminal in the v_active field, 
and the number of active virtual terminals and a bit mask of the 
global state in the vt_state field, where bit x is the state of vt x (1 
indicates that the virtual terminal is open). 

VT->SENDSIG 

The VT_SENDSIG ioctl specifies a signal (in vt_signal) to be sent to 
a bit mask of virtual terminals (in vt_state). 

The data structure used by the VT_GETSTATE and VT_SENDSIG ioctls is: 

struct vt_stat { 

ushort v_-active; /* active vt */ 

ushort v_signal; /* signal to send (VT_SENDSIG) */ 

ushort v_state; /* vt bit mask (VT_SENDSIG and VT_GETSTATE) */ 
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and is defined in /usr/include/sys/vt.h. 
VT_OPENQRY 

The VT_OPENQRY ioctl is used to get the next available virtual ter- 
minal. This value is set in the last argument of the ioctl{2) call. 

GIO_KEYMAP 

This call gets the entire keyboard mapping table from the kernel. 
The structure of the argument is given in /usr/include/sys/kd.h. 

PIO_KEYMAP 

This call sets the entire keyboard mapping table. The structure of 
the argument is given in /usr/include/8ys/kd.h. 

GIO-STRMAP 

This call gets the string key mapping table from the kernel. The 
structure of the argument is given in /usr/include/sys/kd.h. 

PIO_STRMAP 

This call sets the string key mapping table. The structure of the 
argument is given in /usr/include/sy8/kd.h. 

TIOCKBOF 

Extended character codes are disabled. This is the default mode. 
TIOCKBON 

Allows extended characters to be transmitted to the user program. 
The extended characters are transmitted as a null byte followed by a 
second byte containing the character's extended code. When a true 
null byte is sent, it is transmitted as two consecutive null bytes. 

When the keyboard is fully enabled, an 8-bit character code can be obtained 
by holding down the ALT key and entering the 3-digit decimal value of the 
character from the numeric keypad. The character is transmitted when the 
ALT key is released. 

Some keyboard characters have special meaning. Under default operations, 
pressing the DELETE key generates an interrupt signal which is sent to all 
processes designated with the associated control terminal. When the key- 
board is fully enabled, holding down the ALT key and pressing the 8 key 
on the home keyboard (not on the numeric keypad) returns a null byte fol- 
lowed by 0x7F. This will produce the same effect as the DELETE key 
(0x7F) unless you have executed the stty{l) command with the -isig option. 

KBENABLED 

If the keyboard is fully enabled (TIOCKBON), a non-zero value will 
be returned. If the keyboard is not fully enabled (TIOCKBOF), a 
value of zero will be returned. 

GETFKEY 

Obtains the current definition of a function key. The argument to 
the call is the address of one of the following structures defined in 
/usr /include /sys /kd.h: 

struct fkeyarg { 

unsigned int keynum; 

char keydef [MAXFK]; /*Comes from ioctl.h via comcrt.h*/ 
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char flen; 

}; 

The function key number must be passed in keynum (see arg struc- 
ture above). The string currently assigned to the key will be 
returned in keydef and the length of the string will be returned in 
flen when the ioctl is performed. 

SETFKEY 

Assigns a given string to a function key. It uses the same structure 
as the GETFKEY iocti. The function key number must be passed in 
keynum, the string must be passed in keydef, and the length of the 
string (number of characters) must be passed in flen. 

FILES 

/dev/console 

/dev/vtOO-n 

/usr /include /sys /kd.h 

SEE ALSO 

stty(l), console(7), display(7), termio(7). 

ioctl(2), asdi(5) in the Programmer's Reference Manual. 
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NAME 

log - interface to STREAMS error logging and event tracing 
DESCRIPTION 

log is a STREAMS software device driver that provides an interface for the 
STREAMS error logging and event tracing processes [strerr{lM), strace{lM)]. 
log presents two separate interfaces: a function call interface in the kernel 
through which STREAMS drivers and modules submit log messages; and a 
subset of ioctl{2) system calls and STREAMS messages for interaction with a 
user level error logger, a trace logger, or processes that need to submit their 
own log messages. 

Kernel Interface 

log messages are generated within the kernel by calls to the function strlog: 

strlog(mid, sid, level, flags, fmt, argl, ...) 

short mid, sid; 

char level; 

ushort flags; 

char *fmt; 

unsigned argl; 

Required definitions are contained in <sys/strlog.h> and <sys/log.h>. 
mid is the STREAMS module id number for the module or driver submitting 
the log message, sid is an internal sub-id number usually used to identify a 
particular minor device of a driver, level is a tracing level that allows for 
selective screening out of low priority messages from the tracer, flags are 
any combination of SL_ERROR (the message is for the error logger), 
SL_TRACE (the message is for the tracer), SL_FATAL (advisory notification of 
a fatal error), and SL_NOTlFY (request that a copy of the message be mailed 
to the system administrator), fmt is a printf(3S) style format string, except 
that %s, %e, %E, %g, and %G conversion specifications are not handled. 
Up to NLOGARGS (currently 3) numeric or character arguments can be pro- 
vided. 

User Interface 

log is opened via the clone interface, /dev/Iog. Each open of /dev/log 
obtains a separate stream to log. In order to receive log messages, a process 
must first notify log whether it is an error logger or trace logger via a 
STREAMS I_STR ioctl call (see below). For the error logger, the I_STR ioctl 
has an ic_cmd field of I_ERRLOG with no accompanying data. For the trace 
logger, the ioctl has an ic_cmd field of LTRCLOG, and must be accom- 
panied by a data buffer containing an array of one or more struct trace_ids 
elements. Each trace_ids structure specifies an mid, sid, and level from 
which message will be accepted, strlog will accept messages whose mid and 
sid exactly match those in the trace_ids structure, and whose level is less 
than or equal to the level given in the trace_ids structure. A value of -1 in 
any of the fields of the trace_ids structure indicates that any value is 
accepted for that field. 

At most one trace logger and one error logger can be active at a time. Once 
the logger process has identified itself via the ioctl call, log will begin 
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sending up messages subject to the restrictions noted above. These mes- 
sages are obtained via the getmsgd) system call. The control part of this 
message contains a log__ctl structure, which specifies the mid, sid, level, 
flags, time in ticks since boot that the message was submitted, the 
corresponding time in seconds since Jan. 1, 1970, and a sequence number. 
The time in seconds since 1970 is provided so that the date and time of the 
message can be easily computed, and the time in ticks since boot is pro- 
vided so that the relative timing of log messages can be determined. 

Different sequence numbers are maintained for the error and trace logging 
streams, and are provided so that gaps in the sequence of messages can be 
determined (during times of high message traffic, some messages may not 
be delivered by the logger to avoid hogging system resources). The data 
part of the message contains the unexpanded text of the format string (null 
terminated), followed by NLOGARGS words for the arguments to the format 
string, aligned on the first word boundary following the format string. 

A process may also send a message of the same structure to log, even if it is 
not an error or trace logger. The only fields of the log_ctl structure in the 
control part of the message that are accepted are the level and flags fields; 
all other fields are filled in by log before being forwarded to the appropriate 
logger. The data portion must contain a null terminated format string, and 
any arguments (up to NLOGARGS) must be packed one word each, on the 
next word boundary following the end of the format string. 

Attempting to issue an l_TRCLOG or LJERRLOG when a logging process of 
the given type already exists will result in the error ENXIO being returned. 
Similarly, ENXIO is returned for I_TRCLOG ioctls without any trace_ids 
structures, or for any unrecognized 1_STR ioctl calls. Incorrectly formatted 
log messages sent to the driver by a user process are silently ignored (no 
error results). 

EXAMPLES 

Example of I_ERRLOG notification. 

struct strioctl ioc; 
ioc.ic_cmd = L_ERRLOG; 

ioc.ic—timout = 0; /* default timeout (15 sees.) */ 

ioc.ic-Jen = 0; 
ioc.ic_dp = NULL; 

ioctl(log, I_STR, &ioc); 
Example of I_TRCLOG notification. 

struct trace_ids tid[2]; 

tid[0].ti_mid = 2; 
tid[0].ti_sid = 0; 
tid[0].ti_level = 1; 
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tid[l].ti_mid = 1002; 

tid[l].ti_sid = -1; /* any sub-id will be allowed */ 

tid[l].ti_level = -1; /* any level will be allowed */ 

ioc.ic_cmd = LTRCLOG; 
ioc.ic-timout = 0; 

ioc.ic-Jen = 2 * sizeof(struct trace_ids); 
ioc.ic_dp = (char *)tid; 

ioctl(log, I_STR, &ioc); 
Example of submitting a log message (no arguments). 

struct strbuf ctl, dat; 
struct log__ctl Ic; 

char *message = " Don't forget to pick up some milk on the way home " ; 

ctl.len = ctl.maxlen = sizeof(lc); 
ctl.buf = (char *)&lc; 

dat.len = dat.maxlen = strlen(message); 
dat.buf = message; 

Ic.level = 0; 

Ic.flags = SL_ERROR!SL_NOTIFY; 
putmsg(log, &ctl, &dat, 0); 

FILES 

/dev/log, <sys/log.h>, <sys/strlog.h> 

SEE ALSO 

strace(lM), strerr(lM), clone(7). 

intro(2), getmsg(2), putmsg(2) in the Programmer's Reference Manual. 
STREAMS Programmer's Guide. 
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NAME 

Ip - parallel port interface 
DESCRIPTION 

The parallel port (Ip) driver supports both the primary (monochrome) and 
secondary parallel printer adapters simultaneously. Up to two printers are 
supported. If an adapter for a printer is not installed, an attempt to open it 
will fail. The close waits until all output is completed before returning to 
the user. The Ip driver allows only one process at a time to write to the 
adapter. If it is already busy, an open for writing will return an error. How- 
ever, the driver allows multiple opens to occur if they are read-only. 

The parallel printer adapters are character devices. The minor device 
number corresponds to the primary or secondary parallel printer adapter. 
Thus, minor device corresponds to the primary parallel printer adapter, 
while minor device 1 corresponds to the secondary adapter. 

The parallel port behaves as described in termio{7). 

FILES 

/dev/lp* 

ALSO 

stty(l), termio(7). 

ioctl(2) in the Programmer's Reference Manual 
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NAME 

mem, kmem - core memory 
DESCRIPTION 

The file /dev/mem is a special file that is an image of the core memory of 
the computer. It may be used, for example, to examine, and even to patch 
the system. 

Byte addresses in /dev/mem are interpreted as memory addresses. Refer- 
ences to nonexistent locations cause errors to be returned. 

Examining and patching device registers is likely to lead to unexpected 
results when read-only or write-only bits are present. 

The file /dev/kmem is the same as /dev/mem except that kernel virtual 
memory rather than physical memory is accessed. 

I/O is not memory mapped, and the per-process data begins at virtual 
address OxEOOOOOOO. 

FILES 

/dev/mem 
/dev/kmem 

WARNING 

Some of /dev/kmem cannot be read because of write-only addresses or 
unequipped memory addresses. 
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NAME 

null - the null file 
DESCRIPTION 

Data written on the null special file, /dev/null, is discarded. 
Reads from a null special file always return bytes. 

FILES 

/dev/nuU 
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NAME 

prf - operating system profiler 
DESCRIPTION 

The special file /dev/prf provides access to activity information in the 
operating system. Writing the file loads the measurement facility with text 
addresses to be monitored. Reading the file returns these addresses and a 
set of counters indicative of activity between adjacent text addresses. 

The recording mechanism is driven by the system clock and samples the 
program counter at line frequency. Samples that catch the operating system 
are matched against the stored text addresses and increment corresponding 
counters for later processing. 

The file /dev/ prf is a pseudo-device with no associated hardware. 

FILES 

/dev/prf 

SEE ALSO 

profiler(lM). 
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NAME 

qt - QIC cartridge magnetic tape streamer interface 
SYNOPSIS 

qt 

DESCRIPTION 

The format for tape files is described below: 

/dev/rmt/cOsOn no rewind on close, no retension on open 

/dev/rmt/cOsO rewind on close, no retension on open 

/dev/rmt/cOsOnr no rewind on close, retension on open 

/dev/rmt/cOsOr rewind on close, retension on open 

These files refer to the Wangtek PC-36 Controller and the QIC-24/QIC-02 
basic cartridge tape streamer. Only raw character interface files are pro- 
vided. When opened for reading or writing, the tape is assumed to be posi- 
tioned as desired. If the file was retension-on-open, the tape is retensioned 
before any I/O is performed. When a T_RWD, T_RETENSION, T_LOAD, 
or T_UNLOAD ioctl is requested after a write, a double end-of-file (double 
tape mark) is written before the ioctl is executed. When a rewind-on-close 
file is closed, a double end-of-file (double tape mark) is written if the file 
was opened for writing and data was written. When a rewind-on-close file 
is closed, the tape is rewound. If the file is no-rewind-on-close and was 
opened for writing and data was written, only one EOF is written, and the 
tape is positioned after the EOF just written. If the file was no-rewind and 
the file was opened for read-only, the tape is positioned after the EOF fol- 
lowing the data just read. The EOF is returned as a zero-length read. By 
judiciously choosing qt files, it is possible to read and write multifile tapes. 

A standard tape consists of several 512-byte records terminated by an EOF. 
To the extent possible, the system treats the tape like any other file. As in 
other raw devices, seeks are ignored. An EOF is returned as a zero-length 
read, with the tape positioned after the EOF, so that the next read will 
return the next record. 

Only one process is permitted to have any of the tape files open at a given 
time to the extent it is enforceable. Writing after reading is permitted, but 
reading after writing without an intervening rewind is not. If 0_NDELAY 
is clear, opening a retension-on-open file will block until the retension is 
complete. If 0_NDELAY is set, open will return without delay. Opening a 
file with 0_APPEND set is an error (EINVAL). 

The following ioctl's are supported: 

T_RETENSION retension the tape 

T_J^WD rewind the tape to BOT 

T_LOAD rewind the tape to BOT 

T_UNLOAD rewind the tape to BOT 

T_ERASE erase the tape and leave it at BOT 

T_WRFILEM write an EOF (tape mark) 

T_RST reset the tape device 

T_SFF skip forward arg files 
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T-SBF 
T_RDSTAT 



FILES 

/dev /rmt /cOsOn 
/dev/rmt/cOsO 
/dev /rmt /cOsOnr 
/dev/rmt/cOsOr 

SEE ALSO 

intro(7). 



skip forward arg blocks 

read the device status registers into the buffer 
pointed to by arg. 
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NAME 

rtc - real time clock interface 
DESCRIPTION 

The rtc driver supports the real time clock chip, allowing it to be set with 
the correct local time and allowing the time to be read from the chip. 

loctl Calls 

RTCRTIME 

This call is used to read the local time from the real time clock chip. 
The argument to the ioctl is the address of a buffer of RTCNREG 
unsigned characters (RTCNREG is defined as <sys/rtc.h>). The 
ioctl will fill in the buffer with the contents of the chip registers. 
Currently, RTCNREG is 14, and the meanings of the byte registers 
are as follows: 



Register 


Contents 





Seconds 


1 


Second alarm 


2 


Minutes 


3 


Minute alarm 


4 


Hours 


5 


Hour alarm 


6 


Day of week 


7 


Date of month 


8 


Month 


9 


Year 


A 


Status register A 


B 


Status register B 


C 


Status register C 


D 


Status register D 



For further information on the functions of these registers, see your 
hardware technical reference manual. 

RTCSTIME 

This call is used to set the time into the real time clock chip. The 
argument to the ioctl is the address of a buffer of RTCNREGP 
unsigned characters (RTCNREGP as defined in <sys/rtc.h>). 
These bytes should be the desired chip register contents. Currently, 
RTCNREGP is 10, representing registers 0-9 as shown above. 
Note that only the super-user may open the real time clock device 
for writing and that the RTCSTIME ioctl will fail for any other than 
the super-user. 

FILES 

/dev/rtc 
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NAME 

streamio - STREAMS ioctl commands 

SYNOPSIS 

#include <stropts.h> 

int ioctl fildes, command, arg) 

int fildes, command; 

DESCRIPTION 

STREAMS [see intro{2)] ioctl commands are a subset of ioctl(2) system calls 
which perform a variety of control functions on streams. The arguments 
command and arg are passed to the file designated by fildes and are inter- 
preted by the stream head. Certain combinations of these arguments may be 
passed to a module or driver in the stream. 

fildes is an open file descriptor that refers to a stream, command determines 
the control function to be performed as described below, arg represents 
additional information that is needed by this command. The type of arg 
depends upon the command, but it is generally an integer or a pointer to a 
comman^^-specific data structure. 

Since these STREAMS commands are a subset of ioctl, they are subject to the 
errors described there. In addition to those errors, the call will fail with 
ermo set to EINVAL, without processing a control function, if the stream 
referenced by fildes is linked below a multiplexer, or if command is not a 
valid value for a stream. 

Also, as described in ioctl, STREAMS modules and drivers can detect errors. 
In this case, the module or driver sends an error message to the stream head 
containing an error value. This causes subsequent system calls to fail with 
ermo set to this value. 

COMMAND FUNCTIONS 

The following ioctl commands, with error values indicated, are applicable to 
all STREAMS fUes: 

I_PUSH Pushes the module whose name is pointed to by arg onto the 
top of the current stream, just below the stream head. It then 
calls the open routine of the newly-pushed module. On 
failure, ermo is set to one of the following values: 

[EINVAL] Invalid module name. 

[EFAULT] arg points outside the allocated address space. 

[ENXIO] Open routine of new module failed. 

[ENXIO] Hangup received on fildes. 

T POP Removes the module just below the stream head of the stream 

pointed to by fildes. arg should be in an L_POP request. On 
failure, ermo is set to one of the following values: 

[EINVAL] No module present in the stream. 
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[ENXIO] 



Hangup received on fildes. 



I_LOOK 



I_FLUSH 



I_SETSIG 



Retrieves the name of the module just below the stream head 
of the stream pointed to by fildes, and places it in a null ter- 
minated character string pointed at by arg. The buffer 
pointed to by arg should be at least FMNAMESZ+1 bytes long. 
An [#include <sys/conf.h>] declaration is required. On 
failure, errno is set to one of the following values: 

[EFAULT] arg points outside the allocated address space. 
[EINVAL] No module present in stream. 

This request flushes all input and/or output queues, depend- 
ing on the value of arg. Legal arg values are: 

FLUSHR Flush read queues. 
FLUSHW Flush write queues. 
FLUSHRW Flush read and write queues. 

On failure, errno is set to one of the following values: 

[ENOSR] Unable to allocate buffers for flush message 
due to insufficient STREAMS memory resources. 

[EINVAL] Invalid arg value. 

[ENXIO] Hangup received on fildes. 

Informs the stream head that the user wishes the kernel to 
issue the SIGPOLL signal [see signal{2) and sigset{2)] when a 
particular event has occurred on the stream associated with 
fildes. I_SETSIG supports an asynchronous processing capabil- 
ity in STREAMS. The value of arg is a bitmask that specifies 
the events for which the user should be signaled. It is the 
bitwise-OR of any combination of the following constants: 

S_INPUT A non-priority message has arrived on a stream 
head read queue, and no other messages existed 
on that queue before this message was placed 
there. This is set even if the message is of zero 
length. 

S_HIPRI A priority message is present on the stream 
head read queue. This is set even if the mes- 
sage is of zero length. 

S_OUTPUT The write queue just below the stream head is 
no longer full. This notifies the user that there 
is room on the queue for sending (or writing) 
data downstream. 
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S_MSG A STREAMS signal message that contains the 

SIGPOLL signal has reached the front of the 
stream head read queue. 

A user process may choose to be signaled only of priority 
messages by setting the arg bitmask to the value S_HIPRI. 

Processes that wish to receive SIGPOLL signals must explicitly 
register to receive them using I_SETSIG. If several processes 
register to receive this signal for the same event on the same 
Stream, each process will be signaled when the event occurs. 

If the value of arg is zero, the calling process will be unre- 
gistered and will not receive further SIGPOLL signals. On 
failure, errno is set to one of the following values: 

[EINVAL] arg value is invalid or arg is zero and process is 
not registered to receive the SIGPOLL signal. 

[EAGAIN] Allocation of a data structure to store the signal 
request failed. 

L-GETSIG Returns the events for which the calling process is currently 
registered to be sent a SIGPOLL signal. The events are 
returned as a bitmask pointed to by arg, where the events are 
those specified in the description of I_SETSIG above. On 
failure, errno is set to one of the following values: 

[EINVAL] Process not registered to receive the SIGPOLL 
signal. 

[EFAULT] arg points outside the allocated address space. 

I_FIND Compares the names of all modules currently present in the 

stream to the name pointed to by arg, and returns 1 if the 
named module is present in the stream. It returns if the 
named module is not present. On failure, errno is set to one 
of the following values: 

[EFAULT] arg points outside the allocated address space. 
[EINVAL] arg does not contain a valid module name. 

L_PEEK Allows a user to retrieve the information in the first message 

on the stream head read queue without taking the message off 
the queue, arg points to a strpeek structure which contains 
the following members: 

struct strbuf ctlbuf; 
struct strbuf databuf ; 
long flags; 

The maxlen field in the ctlbuf and databuf strbuf structures [see 
getmsg{2)] must be set to the number of bytes of control 
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information and/or data infonnation, respectively, to retrieve. 
If the user sets flags to RS_HIPRI, L_PEEK will only look for a 
priority message on the stream head read queue. 

LJPEEK returns 1 if a message was retrieved, and returns if 
no message was found on the stream head read queue, or if 
the RS— HIPRI flag was set in flags and a priority message was 
not present on the stream head read queue. It does not wait 
for a message to arrive. On return, ctlbuf specifies informa- 
tion in the control buffer, databuf specifies information in the 
data buffer, and flags contains the value or RS_HIPRI. On 
failure, errno is set to one of the following values: 

[EFAULT] arg points, or the buffer area specified in ctlbuf 
or databuf is, outside the allocated address 
space. 

[EBADMSG] Queued message to be read is not valid for 
LJPEEK 

I_SRDOPT Sets the read mode using the value of the argument arg. 
Legal arg values are: 

RNORM Byte-stream mode, the default. 
RMSGD Message-discard mode. 
RMSGN Message-nondiscard mode. 

Read modes are described in read{2). On failure, errno is set 
to the following value: 

[EINVAL] arg is not one of the above legal values. 

I_GRDOPT Returns the current read mode setting in an int pointed to by 
the argument arg. Read modes are described in read{2). On 
failure, errno is set to the following value: 

[EFAULT] arg points outside the allocated address space. 

I_NREAD Counts the number of data bytes in data blocks in the first 
message on the stream head read queue, and places this value 
in the location pointed to by arg. The return value for the 
command is the number of messages on the stream head read 
queue. For example, if zero is returned in arg, but the ioctl 
return value is greater than zero, this indicates that a zero- 
length message is next on the queue. On failure, errno is set 
to the following value: 

[EFAULT] arg points outside the allocated address space. 

I_FDINSERT Creates a message from user specified buffer(s), adds informa- 
tion about another stream and sends the message 
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downstream. The message contains a control part and an 
optional data part. The data and control parts to be sent are 
distinguished by placement in separate buffers, as described 
below. 

arg points to a strfdinsert structure which contains the follow- 
ing members: 

struct strbuf ctlbuf; 

struct strbuf databuf ; 

long flags; 

int fildes; 

int offset; 

The len field in the ctlbuf strbuf structure [see putmsg(2)] must 
be set to the size of a pointer plus the number of bytes of 
control information to be sent with the message, fildes in the 
strfdinsert structure specifies the file descriptor of the other 
stream, offset, which must be word-aligned, specifies the 
number of bytes beyond the beginning of the control buffer 
where L_FDINSERT will store a pointer. This pointer will be 
the address of the read queue structure of the driver for the 
stream corresponding to fildes in the strfdinsert structure. The 
len field in the databuf strbuf structure must be set to the 
number of bytes of data information to be sent with the mes- 
sage or zero if no data part is to be sent. 

flags specifies the type of message to be created. A non- 
priority message is created if flags is set to 0, and a priority 
message is created if flags is set to RS_HIPRI. For non-priority 
messages, I_FDINSERT will block if the stream write queue is 
full due to internal flow control conditions. For priority mes- 
sages, L_FDINSERT does not block on this condition. For 
non-priority messages, I_FDINSERT does not block when the 
write queue is full and 0_NDELAY is set. Instead, it fails and 
sets ermo to EAGAIN. 

I—FDINSERT also blocks, unless prevented by lack of internal 
resources, waiting for the availability of message blocks in the 
stream, regardless of priority or whether 0_NDELAY has been 
specified. No partial message is sent. On failure, errno is set 
to one of the following values: 

[EAGAIN] A non-priority message was specified, the 
0_NDELAY flag is set, and the stream write 
queue is full due to internal flow control condi- 
tions. 

[ENOSR] Buffers could not be allocated for the message 
that was to be created due to insufficient 
STREAMS memory resources. 

[EFAULT] arg points, or the buffer area specified in ctlbuf 
or databuf is, outside the allocated address 
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space. 

One of the following: fildes in the strfdinsert 
structure is not a valid, open stream file 
descriptor; the size of a pointer plus offset is 
greater than the len field for the buffer speci- 
fied through ctlptr; offset does not specify a 
properly aligned location in the data buffer; an 
undefined value is stored in flags. 

Hangup received on fildes of the ioctl call or 
fildes in the strfdinsert structure. 

The len field for the buffer specified through 
databuf does not fall within the range specified 
by the maximum and minimum packet sizes of 
the topmost stream module, or the len field for 
the buffer specified through databuf is larger 
than the maximum configured size of the data 
part of a message, or the len field for the buffer 
specified through ctlbuf is larger than the max- 
imum configured size of the control part of a 
message. 

L-FDINSERT can also fail if an error message was received by 
the stream head of the stream corresponding to fildes in the 
strfdinsert structure. In this case, errno will be set to the value 
in the message. 

LSTR Constructs an internal STREAMS ioctl message from the data 

pointed to by arg and sends that message downstream. 

This mechanism is provided to send user ioctl requests to 
downstream modules and drivers. It allows information to be 
sent with the ioctl and will return to the user any information 
sent upstream by the downstream recipient. I_STR blocks 
until the system responds with either a positive or negative 
acknowledgment message or until the request "times out" 
after some period of time. If the request times out, it fails 
with errno set to ETIME. 

At most, one I_STR can be active on a stream. Further I_STR 
calls will block until the active I_STR completes at the stream 
head. The default timeout interval for these requests is 15 
seconds. The 0_NDELAY [see open{2)] flag has no effect on 
this call. 

To send requests downstream, arg must point to a strioctl 
structure which contains the following members: 

int ic__cmd; /* downstream command */ 

int ic_timout ; /* ACK/NAK timeout */ 

int ic_len ; /* length of data arg */ 

char *ic_dp ; /* ptr to data arg */ 



[EINVAL] 

[ENXIO] 
[ERANGE] 
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ic—cmd is the internal ioctl command intended for a down- 
stream module or driver; and ic—timout is the number of 
seconds (-1 = infinite, = use default, >0 = as specified) an 
I_STR request will wait for acknowledgment before timing 
out. ic-Jen is the number of bytes in the data argument and 
ic—dp is a pointer to the data argument. The ic—len field has 
two uses: on input, it contains the length of the data argu- 
ment passed in, and on return from the command, it contains 
the number of bytes being returned to the user (the buffer 
pointed to by ic^dp should be large enough to contain the 
maximum amount of data that any module or the driver in 
the stream can return). 

The stream head will convert the information pointed to by 
the strioctl structure to an internal ioctl command message 
and send it downstream. On failure, errno is set to one of the 
following values: 

[ENOSR] Unable to allocate buffers for the ioctl message 
due to insufficient STREAMS memory resources. 

[EFAULT] arg points, or the buffer area specified by ic—dp 
and ic—len (separately for data sent and data 
returned) is, outside the allocated address 
space. 

[EINVAL] ic—len is less than or ic—len is larger than the 
maximum configured size of the data part of a 
message or ic—timout is less than -1. 

[ENXIO] Hangup received on fildes, 

[ETIME] A downstream ioctl timed out before ack- 

nowledgment was received. 

An I_STR can also fail while waiting for an acknowledgment 
if a message indicating an error or a hangup is received at the 
stream head. In addition, an error code can be returned in the 
positive or negative acknowledgment message, in the event 
the ioctl command sent downstream fails. For these cases, 
I_STR will fail with errno set to the value in the message. 

I_SENDFD Requests the stream associated with fildes to send a message, 
containing a file pointer, to the stream head at the other end 
of a stream pipe. The file pointer corresponds to arg, which 
must be an integer file descriptor. 

I_SENDFD converts arg into the corresponding system file 
pointer. It allocates a message block and inserts the file 
pointer in the block. The user id and group id associated 
with the sending process are also inserted. This message is 
placed directly on the read queue [see intro{2)] of the stream 
head at the other end of the stream pipe to which it is con- 
nected. On failure, errno is set to one of the following values: 
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[EAGAIN] The sending stream is unable to allocate a mes- 
sage block to contain the file pointer. 

[EAGAIN] The read queue of the receiving stream head is 
full and cannot accept the message sent by 
I_SENDFD. 

[EBADF] arg is not a valid, open file descriptor. 
[EINVAL] fildes is not connected to a stream pipe. 
[ENXIO] Hangup received on fildes. 

I_RECVFD Retrieves the file descriptor associated with the message sent 
by an LSENDFD ioctl over a stream pipe, arg is a pointer to a 
data buffer large enough to hold an strrecvfd data structure 
containing the following members: 

int fd; 

unsigned short uid; 
unsigned short gid; 
char f ill[8] ; 

fd is an integer file descriptor, uid and gid are the user id and 
group id, respectively, of the sending stream. 

If 0_NDELAY is not set [see open{2)l I_RECVFD will block 
until a message is present at the stream head. If 0_NDELAY is 
set, LJRECVFD will fail with ermo set to EAGAIN if no message 
is present at the stream head. 

If the message at the stream head is a message sent by an 
LSENDFD, a new user file descriptor is allocated for the file 
pointer contained in the message. The new file descriptor is 
placed in the fd field of the strrecvfd structure. The structure 
is copied into the user data buffer pointed to by arg. On 
failure, errno is set to one of the following values: 

[EAGAIN] A message was not present at the stream head 
read queue, and the 0_NDELAY flag is set. 

[EBADMSG] The message at the stream head read queue was 
not a message containing a passed file descrip- 
tor. 

[EFAULT] arg points outside the allocated address space. 
[EMFILE] NOFILES file descriptors are currently open. 
[ENXIO] Hangup received on fildes. 

The following two commands are used for connecting and disconnecting 
multiplexed STREAMS configurations. 

I_LINK Connects two streams, where fildes is the file descriptor of the 

stream connected to the multiplexing driver, and arg is the file 
descriptor of the stream connected to another driver. The 
stream designated by arg gets connected below the 
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multiplexing driver. I_LINK requires the multiplexing driver 
to send an acknowledgment message to the stream head 
regarding the linking operation. This call returns a multi- 
plexer ID number (an identifier used to disconnect the multi- 
plexer, see L_UNLINK) on success, and a -1 on failure. On 
failure, errno is set to one of the following values: 

[ENXIO] Hangup received on fildes, 

[ETIME] Time out before acknowledgment message was 

received at stream head. 

[EAGAIN] Temporarily unable to allocate storage to per- 
form the I_LINK. 

[ENOSR] Unable to allocate storage to perform the 
I_LINK due to insufficient STREAMS memory 
resources. 

[EBADF] arg is not a valid, open file descriptor. 

[EINVAL] fildes stream does not support multiplexing. 

[EINVAL] arg is not a stream, or is already linked under a 
multiplexer. 

[EINVAL] The specified link operation would cause a 
"cycle" in the resulting configuration; that is, 
if a given stream head is linked into a multi- 
plexing configuration in more than one place. 

An 1_LINK can also fail while waiting for the multiplexing 
driver to acknowledge the link request, if a message indicat- 
ing an error or a hangup is received at the stream head of 
fildes. In addition, an error code can be returned in the posi- 
tive or negative acknowledgment message. For these cases, 
I_LINK will fail with errno set to the value in the message. 

I_UNLINK Disconnects the two streams specified by fildes and arg. fildes 
is the file descriptor of the stream connected to the multiplex- 
ing driver, fildes must correspond to the stream on which the 
ioctl L_LINK command was issued to link the stream below the 
multiplexing driver, arg is the multiplexer ID number that 
was returned by the I_LINK. If arg is -1, then all Streams 
which were linked to fildes are disconnected. As in I_LINK, 
this command requires the multiplexing driver to ack- 
nowledge the unlink. On failure, errno is set to one of the 
following values: 

[ENXIO] Hangup received on fildes. 

[ETIME] Time out before acknowledgment message was 

received at stream head. 

[ENOSR] Unable to allocate storage to perform the 
I_UNLINK due to insufficient STREAMS memory 
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resources. 

[EINVAL] arg is an invalid multiplexer ID nunaber or 
fildes is not the stream on which the I_LINK 
that returned arg was performed. 

An I_UNLINK can also fail while waiting for the multiplexing 
driver to acknowledge the link request, if a message indicat- 
ing an error or a hangup is received at the stream head of 
fildes. In addition, an error code can be returned in the posi- 
tive or negative acknowledgment message. For these cases, 
I_UNLINK will fail with errno set to the value in the message. 

SEE ALSO 

close(2), fcntl(2), intro(2), ioctl(2), open(2), read(2), getmsg(2), poll(2), 
putmsg(2), signal{2), sigset(2), write(2) in the Programmer's Reference 
Manual. 

STREAMS Programmer's Guide. 
STREAMS Primer. 

DIAGNOSTICS 

Unless specified otherwise above, the return value from ioctl is upon suc- 
cess and -1 upon failure with errno set as indicated. 
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NAME 

sxt - pseudo-device driver 
DESCRIPTION 

The special file /dev/sxt is a pseudo-device driver that interposes a discip- 
line between the standard tty line disciplines and a real device driver. The 
standard disciplines manipulate virtual tty structures (channels) declared by 
the /dev/sxt driver, /dev/sxt acts as a discipline manipulating a real tty 
structure declared by a real device driver. The /dev/sxt driver is currently 
only used by the shl{\) command. 

Virtual ttys are named by inodes in the subdirectory /dev/sxt and are allo- 
cated in groups of up to eight. To allocate a group, a program should 
exclusively open a file with a name of the form /dev/sxt/??0 (channel 0) 
and then execute a SXTIOCLINK ioctl call to initiate the multiplexing. 

Only one channel, the controlling channel, can receive input from the key- 
board at a time; others attempting to read will be blocked. 

There are two groups of ioctl (2) commands supported by sxt. The first 
group contains the standard ioctl commands described in termio{7), with the 
addition of the following: 

TIOCEXCL Set exclusive use mode: no further opens are permitted 

until the file has been closed. 

TIOCNXCL Reset exclusive use mode: further opens are once 

again permitted. 

The second group are commands to sxt itself. Some of these may only be 
executed on channel 0. 

SXTIOCLINK Allocate a channel group and multiplex the virtual 

ttys onto the real tty. The argument is the number of 
channels to allocate. This command may only be 
executed on channel 0. Possible errors include: 



SXTIOCSWTCH 



EINVAL The argument is out of range. 

ENOTTY The command was not issued from a real 
tty. 

ENXIO linesw is not configured with sxt. 

EBUSY An SXTIOCLINK command has already 
been issued for this real tty. 

ENOMEM There is no system memory available for 
allocating the virtual tty structures. 

EBADF Channel was not opened before this call. 
Set the controlling channel. Possible errors include: 

EINVAL An invalid channel number was given. 

EPERM The command was not executed from 
channel 0. 
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SXTIOCWF 



SXTIOCUBLK 



SXTIOCSTAT 



SXTIOCTRACE 



SXTIOCNOTRACE 



Cause a channel to wait until it is the controlling 
channel. This conunand will return the error EINVAL 
if an invalid channel number is given. 

Turn off the loblk control flag in the virtual tty of the 
indicated channel. The error EINVAL wiil be returned 
if an invalid number or channel is given. 

Get the status (blocked on input or output) of each 
channel and store in the sxthlock structure referenced 
by the argument. The error EFAULT will be returned 
if the structure cannot be written. 

Enable tracing. Tracing information is written to the 
console. This command has no effect if tracing is not 
configured. 

Disable tracing. This command has no effect if trac- 
ing is not configured. 



FILES 

/dev/sxt/??[0-7] Virtual tty devices 

SEE ALSO 

shl(l), stty(l), termio(7). 

ioctl(2), open(2) in the Programmer's Reference Manual 
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NAME 

termio - general terminal interface 
DESCRIPTION 

All of the asynchronous communications ports use the same general inter- 
face, no matter what hardware is involved. The remainder of this section 
discusses the common features of this interface. 

When a terminal file is opened, it normally causes the process to wait until 
a connection is established. In practice, users' programs seldom open termi- 
nal files; they are opened by getty and become a user's standard input, out- 
put, and error files. The very first terminal file opened by the process group 
leader of a terminal file not already associated with a process group 
becomes the control terminal for that process group. The control terminal 
plays a special role in handling quit and interrupt signals, as discussed 
below. The control terminal is inherited by a child process during a fork(l), 
A process can break this association by changing its process group using 
setpgrp{l). 

A terminal associated with one of these files ordinarily operates in full- 
duplex mode. Characters may be typed at any time, even while output is 
occurring, and are only lost when the system's character input buffers 
become completely full, which is rare, or when the user has accumulated 
the maximum allowed number of input characters that have not yet been 
read by some program. Currently, this limit is 256 characters. When the 
input limit is reached, the buffer is flushed and all the saved characters are 
thrown away without notice. 

Normally, ternunal input is processed in units of lines. A line is delimited 
by a new-line (ASCII LF) character, an end-of-file (ASCII EOT) character, or 
an end-of-line character. This means that a program attempting to read will 
be suspended until an entire line has been typed. Also, no matter how 
many characters are requested in the read call, at most one line will be 
returned. It is not, however, necessary to read a whole line at once; any 
number of characters may be requested in a read, even one, without losing 
information. 

During input, erase and kill processing is normally done. By default, the 
character # erases the last character typed, except that it will not erase 
beyond the beginning of the line. By default, the character @ kills (deletes) 
the entire input line, and optionally outputs a new-line character. Both 
these characters operate on a key-stroke basis, independently of any back- 
spacing or tabbing that may have been done. Both the erase and kill char- 
acters may be entered literally by preceding them with the escape character 
(\). In this case, the escape character is not read. The erase and kill charac- 
ters may be changed. 
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Certain characters have special functions on input. These functions and 

their default character values are summarized as follows: 

INTR ( RUBOUT or ASCII DEL) generates an interrupt signal which is sent 
to all processes with the associated control terminal. Normally, 
each such process is forced to terminate, but arrangements may be 
made either to ignore the signal or to receive a trap to an agreed- 
upon location; see signal{2). 

QUIT (CTRL- or ASCII FS) generates a quit signal. Its treatment is identi- 
cal to the interrupt signal except that, unless a receiving process 
has made other arrangements, it v^U not only be terminated but a 
core image file (called core) will be created in the current working 
directory. 

SWTCH (CTRL-Z or ASCII SUB) is used by the job control facility, shl, to 
change the current layer to the control layer. 

ERASE (#) erases the preceding character. It will not erase beyond the 
start of a line, as delimited by a NL, EOF, or EOL character. 

KILL {@) deletes the entire line, as delimited by a NL, EOF, or EOL char- 
acter. 

EOF (CTRL-D or ASCII EOT) may be used to generate an end-of-file 
from a terminal. When received, all the characters waiting to be 
read are immediately passed to the program, without waiting for a 
new-line, and the EOF is discarded. Thus, if there are no charac- 
ters waiting, which is to say the EOF occurred at the beginning of a 
line, zero characters will be passed back, which is the standard 
end-of-file indication. 

NL (ASCII LF) is the normal line delimiter. It cannot be changed or 
escaped. 

EOL (ASCII NUL) is an additional line delimiter, like NL. It is not nor- 
mally used. 
EOL2 is another additional line delimiter. 

STOP (CTRL-S or ASCII DC3) can be used to temporarily suspend output. 

It is useful with CRT terminals to prevent output from disappearing 
before it can be read. While output is suspended, STOP characters 
are ignored and not read. 

START (CTRL-Q or ASCII DCl) is used to resume output which has been 
suspended by a STOP character. While output is not suspended, 
START characters are ignored and not read. The start/stop charac- 
ters can not be changed or escaped. 

The character values for INTR, QUIT, SWTCH, ERASE, KILL, EOF, and EOL 
may be changed to suit individual tastes. The ERASE, KILL, and EOF charac- 
ters may be escaped by a preceding \ character, in which case no special 
function is done. 

When the carrier signal from the data-set drops, a hang-up signal is sent to 
all processes that have this terminal as the control terminal. Unless other 
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arrangements have been made, this signal causes the processes to terminate. 
If the hang-up signal is ignored, any subsequent read returns with an end- 
of-file indication. Thus, programs that read a terminal and test for end-of- 
file can terminate appropriately when hung up on. 

When one or more characters are written, they are transmitted to the termi- 
nal as soon as previously-written characters have finished typing. Input 
characters are echoed by putting them in the output queue as they arrive. If 
a process produces characters more rapidly than they can be typed, it will 
be suspended when its output queue exceeds some limit. When the queue 
has drained down to some threshold, the program is resumed. 

Several ioctl{2) system calls apply to terminal files. The primary calls use 
the following structure, defined in <tennio.h>: 

#define 
struct 



NCC 


8 






termio { 








unsigned 


short 


c_iflag; 


/* input modes */ 


unsigned 


short 


c_oflag; 


/* output modes */ 


unsigned 


short 


c_cflag; 


/* control modes */ 


unsigned 


short 


c_lflag; 


/* local modes */ 


char 




c_line; 


/* line discipline */ 


unsigned 


char 


c_cc[NCC]; 


/* control chars */ 



The XENIX extension ioctl calls use the following structures that are defined 
in <ttold.h>: 



struct 



sgttyb { 

char 

char 

char 

char 

short 



sg_ispeed; 

sg_ospeed; 

sg_erase; 

sg_kill; 

sg_flags; 



struct 



}; 



tc{ 

char 

char 

char 

char 

char 

char 



t_intrc; 

t_quitc; 

t_startc; 

t_stopc; 

t_eofc; 

t_brkc; 



The special control characters are defined by the array c_cc. 
positions and initial values for each function are as follows: 

VINTR DEL 

1 VQUIT FS 

2 VERASE # 

3 VKILL @ 

4 VEOF EOT 



The relative 
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5 VEOL NUL 

6 reserved 

7 SWTCH 



IGNBRK 


0000001 


BRKINT 


0000002 


IGNPAR 


0000004 


PARMRK 


0000010 


INPCK 


0000020 


ISTRIP 


0000040 


INLCR 


0000100 


IGNCR 


0000200 


ICRNL 


0000400 


lUCLC 


0001000 


IXON 


0002000 


IXANY 


0004000 


IXOFF 


0010000 



The C—iflag field describes the basic terminal input control: 

Ignore break condition. 
Signal interrupt on break. 
Ignore characters with parity errors. 
Mark parity errors. 
Enable input parity check. 
Strip character. 
Map NL to CR on input. 
Ignore CR. 

Map CR to NL on input. 
Map uppercase to lowercase on input. 
Enable start/stop output control. 
Enable any character to restart output. 
Enable start/stop input control. 

If IGNBRK is set, the break condition (a character-framing error with data all 
zeros) is ignored, that is, not put on the input queue and therefore not read 
by any process. Otherwise if BRKINT is set, the break condition will gen- 
erate an interrupt signal and flush both the input and output queues. If 
IGNPAR is set, characters with other framing and parity errors are ignored. 

If PARMRK is set, a character with a framing or parity error which is not 
ignored is read as the three-character sequence: 0377, 0, X, where X is the 
data of the character received in error. To avoid ambiguity in this case, if 
ISTRIP is not set, a valid character of 0377 is read as 0377, 0377. If PARMRK 
is not set, a framing or parity error which is not ignored is read as the char- 
acter NUL (0). 

If INPCK is set, input parity checking is enabled. If INPCK is not set, input 
parity checking is disabled. This allows output parity generation without 
input parity errors. 

If ISTRIP is set, valid input characters are first stripped to 7-bits, otherwise 
all 8-bits are processed. 

If INLCR is set, a received NL character is translated into a CR character. If 
IGNCR is set, a received CR character is ignored (not read). Otherwise if 
ICRNL is set, a received CR character is translated into a NL character. 

If lUCLC is set, a received uppercase alphabetic character is translated into 
the corresponding lowercase character. 

If IXON is set, start/stop output control is enabled. A received STOP charac- 
ter will suspend output and a received START character will restart output. 
All start/stop characters are ignored and not read. If IXANY is set, any 
input character will restart output which has been suspended. 

If IXOFF is set, the system will transmit START/STOP characters when the 
input queue is nearly empty/full. 
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The initial input control value is all-bits-clear. 

The c—oflag field specifies the system treatment of output: 



OPOST 


0000001 


Postprocess output. 


OLCUC 


0000002 


Map lower case to upper on output. 


ONLCR 


0000004 


Map NL to CR-NL on output. 


OCRNL 


0000010 


Map CR to NL on output. 


ONOCR 


0000020 


No CR output at column 0. 


ONLRET 


0000040 


NL performs CR function. 


OHLL 


0000100 


Use fill characters for delay. 


OFDEL 


0000200 


Fill is DEL, else NUL. 


NLDLY 


0000400 


Select new-line delays: 


NLO 







NLl 


0000400 




CRDLY 


0003000 


Select carriage-return delays: 


CRO 







CRl 


0001000 




CR2 


0002000 




CR3 


0003000 




TABDLY 


0014000 


Select horizontal-tab delays: 


TABO 







TABl 


0004000 




TAB2 


0010000 




TAB3 


0014000 


Expand tabs to spaces. 


BSDLY 


0020000 


Select backspace delays: 


BSO 







BSl 


0020000 




VTDLY 


0040000 


Select vertical-tab delays: 


VTO 







VTl 


0040000 




FFDLY 


0100000 


Select form-feed delays: 


FFO 







FFl 


0100000 





If OPOST is set, output characters are post-processed as indicated by the 
remaining flags; otherwise, characters are transnutted without change. 
If OLCUC is set, a lowercase alphabetic character is transmitted as the 
corresponding uppercase character. This function is often used in conjunc- 
tion with lUCLC. 

If ONLCR is set, the NL character is transmitted as the CR-NL character pair. 
If OCRNL is set, the CR character is transmitted as the NL character. If 
ONOCR is set, no CR character is transmitted when at column (first posi- 
tion). If ONLRET is set, the NL character is assumed to do the carriage- 
return function; the column pointer will be set to and the delays specified 
for CR will be used. Otherwise, the NL character is assumed to do just the 
line-feed function; the column pointer will remain unchanged. The column 
pointer is also set to if the CR character is actually transmitted. 

The delay bits specify how long transmission stops to allow for mechanical 
or other movement when certain characters are sent to the terminal. In all 
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cases a value of indicates no delay. If OFILL is set, fill characters will be 
transmitted for delay instead of a timed delay. This is useful for high baud 
rate terminals which need only a minimal delay. If OFDEL is set, the fill 
character is DEL, otherwise NUL. 

If a form-feed or vertical-tab delay is specified, it lasts for about 2 seconds. 

New-line delay lasts about 0.10 seconds. If ONLRET is set, the carriage- 
return delays are used instead of the new-line delays. If OFILL is set, two 
fill characters will be transmitted. 

Carriage-return delay type 1 is dependent on the current column position, 
type 2 is about 0.10 seconds, and type 3 is about 0.15 seconds. If OFILL is 
set, delay type 1 transmits two fill characters, and type 2, four fill charac- 
ters. 

Horizontal-tab delay type 1 is dependent on the current column position. 
Type 2 is about 0.10 seconds. Type 3 specifies that tabs are to be expanded 
into spaces. If OFILL is set, two fill characters will be transmitted for any 
delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, one fill character 
will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all-bits-clear. 

The C—cflag field describes the hardware control of the terminal: 



CBAUD 


0000017 


Baud rate: 


BO 





Hang up 


B50 


0000001 


50 baud 


B75 


0000002 


75 baud 


BllO 


0000003 


110 baud 


B134 


0000004 


134 baud 


B150 


0000005 


150 baud 


B200 


0000006 


200 baud 


B300 


0000007 


300 baud 


B600 


0000010 


600 baud 


B1200 


0000011 


1200 baud 


B1800 


0000012 


1800 baud 


B2400 


0000013 


2400 baud 


B4800 


0000014 


4800 baud 


B9600 


0000015 


9600 baud 


B19200 


0000016 


19200 baud 


EXTA 


0000016 


External A 


B38400 


0000017 


38400 baud 


EXTB 


0000017 


External B 


CSIZE 


0000060 


Character size: 


CSS 





5 bits 


CS6 


0000020 


6 bits 


CS7 


0000040 


7 bits 


CSS 


0000060 


8 bits 


CSTOPB 


0000100 


Send two stop bits, else one. 
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CREAD 

PARENB 

PARODD 

HUPCL 

CLOCAL 

RCVIEN 

XMTIEN 

LOBLK 



0000200 
0000400 
0001000 
0002000 
0004000 
0010000 
0020000 
0040000 



Enable receiver. 
Parity enable. 
Odd parity, else even. 
Hang up on last close. 
Local line, else dial-up. 



Block layer output. 



The CBAUD bits specify the baud rate. The zero baud rate, BO, is used to 
hang up the connection. If BO is specified, the data-terminal-ready signal 
will not be asserted. Normally, this will disconnect the line. For any partic- 
ular hardware, impossible speed changes are ignored. 

The CSIZE bits specify the character size in bits for both transmission and 
reception. This size does not include the parity bit, if any. If CSTOPB is set, 
two stop bits are used, otherwise one stop bit. For example, at 110 baud, 
two stops bits are required. 

If PARENB is set, parity generation and detection is enabled and a parity bit 
is added to each character. If parity is enabled, the PARODD flag specifies 
odd parity if set; otherwise, even parity is used. 

If CREAD is set, the receiver is enabled; otherwise, no characters will be 
received. 

If HUPCL is set, the line will be disconnected when the last process with the 
line open closes it or terminates. That is, the data-terminal-ready signal will 
not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct connection with no 
modem control. Otherwise, modem control is assumed. 
If LOBLK is set, the output of a job control layer will be blocked when it is 
not the current layer. Otherwise, the output generated by that layer will be 
multiplexed onto the current layer. 

The initial hardware control value after open is B300, CSS, CREAD, HUPCL. 
The c^lflag field of the argument structure is used by the line discipline to 
control terminal functions. The basic line discipline (0) provides the follow- 
ing: 

Enable signals. 

Canonical input (erase and kill processing). 
Canonical upper/lower presentation. 
Enable echo. 

Echo erase character as BS-SP-BS. 
Echo NL after kill character. 
Echo NL. 

Disable flush after interrupt or quit. 

If ISIG is set, each input character is checked against the special control 
characters INTR, SWTCH, and QUIT. If an input character matches one of 
these control characters, the function associated with that character is 



ISIG 


0000001 


ICANON 


0000002 


XCASE 


0000004 


ECHO 


0000010 


ECHOE 


0000020 


ECHOK 


0000040 


ECHONL 


0000100 


NOFLSH 


0000200 
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performed. If ISIG is not set, no checking is done. Thus these special input 
functions are possible only if ISIG is set. These functions may be disabled 
individually by changing the value of the control character to an unlikely or 
impossible value (e.g., 0377). 

If ICANON is set, canonical processing is enabled. This enables the erase 
and kill edit functions, and the assembly of input characters into lines del- 
imited by NL, EOF, and EOL. If ICANON is not set, read requests are satis- 
fied directly from the input queue. A read will not be satisfied until at least 
MIN characters have been received or the timeout value TIME has expired 
between characters. This allows fast bursts of input to be read efficiently 
while still allowing single character input. The MIN and TIME values are 
stored in the position for the EOF and EOL characters, respectively. The 
time value represents tenths of seconds. 

If XCASE is set, and if ICANON is set, an uppercase letter is accepted on 
input by preceding it with a \ character, and is output preceded by a \ char- 
acter. In this mode, the following escape sequences are generated on output 
and accepted on input: 

for: use: 

y 
\ 



\ w 

For example, A is input as \a, \n as \\n, and \N as \\\n. 
If ECHO is set, characters are echoed as received. 

When ICANON is set, the following echo functions are possible. If ECHO 
and ECHOE are set, the erase character is echoed as ASCII BS SP BS, which 
will clear the last character from a CRT screen. If ECHOE is set and ECHO is 
not set, the erase character is echoed as ASCII SP BS. If ECHOK is set, the NL 
character will be echoed after the kill character to emphasize that the line 
will be deleted. Note that an escape character preceding the erase or kill 
character removes any special function. If ECHONL is set, the NL character 
will be echoed even if ECHO is not set. This is useful for terminals set to 
local echo (so-called half duplex). Unless escaped, the EOF character is not 
echoed. Because EOT is the default EOF character, this prevents terminals 
that respond to EOT from hanging up. 

If NOFLSH is set, the normal flush of the input and output queues associated 
with the quit, switch, and interrupt characters will not be done. 

The initial line-discipline control value is all-bits-clear. 

The primary ioctl(2) system calls have the following form: 

ioctl(fildes, command, arg); 

where fildes is the file descriptor of the opened tty device, command is the 
iocti type, and arg is a buffer or structure depending on the ioctl call used. 
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For the following calls using this form, the arg is of type: 
struc termio *arg; 

TCGETA 

Gets the parameters associated with the terminal and store 
them in the termio structure referenced by arg, 

TCSETA 

Sets the parameters associated with the terminal from the 
structure referenced by arg. The change is immediate. 

TCSETAW 

Waits for the output to drain before setting the new parame- 
ters. This form should be used when changing parameters 
that will affect output. 

TCSETAF 

Waits for the output to drain, then flush the input queue 
and set the new parameters. 

For the following calls using this form, the arg parameter must be a pointer 
to a buffer of size 1024: 

LDSMAP 

Sets the input/output mapping on a channel. 
LDGMAP 

Gets the input/output mapping on a channel. 
LDNMAP 

Turns off the input/output mapping on a channel. The arg 
for this call must be a NUL pointer. 

For the following ioctl calls, the arg parameter is of type: 
struc tc *arg; 

TIOCGETC 

Gets the current settings of special characters. 
TIOCSETC 

Changes the settings for special characters. 

The TIOCSETN ioctl call requires a different arg type. The arg for this call 
must be of type: 

struc sgttyb *arg; 
TIOCSETN 

Sets the parameters associated with the terminal, but does 
not delay or flush the input. 
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For the following ioctl calls, the arg is of type NUL: 
TIOCEXCL 

Sets exclusive use mode: no futher opens are permitted until 
the file has been closed. 

TIONEXCL 

Resets exclusive use mode: further opens are once again 
permitted. 

TIOCHPCL 

When the file is closed for the last time, hang up the termi- 
nal. 

TIOCFLUSH 

All characters waiting in the input or output queues are 
flushed. 

FIORDCHK 

Return a non-zero value if there are characters on the input. 

Additional ioctl(2) calls have the form: 
ioctl (fildes, command, arg) 

where arg is of type int or a pointer to an unsigned short, depending on the 
ioctl call used. 

For the following ioctl calls using this form, the arg is of type int: 

TCSBRK Wait for the output to drain. If arg is 0, then send a 
break (zero bits for 0.25 seconds). 

TCXONC Start/stop control. If arg is 0, suspend output; if 1, 
restart suspended output. 

TCFLSH If arg is 0, flush the input queue; if 1, flush the output 
queue; if 2, flush both the input and output queues. 

For the following ioctl calls using this form, the arg is of type: 
unsigned short *arg; 

TIOCGETD 

Gets the line discipline associated with the terminal. 
TIOCSETD 

Sets the line discipline associated with the terminal. 

The DIOCSETP and DIOCGETP ioctl calls are no-op calls which have been 
retained for backwards compatibility. 

FILES 

/dev/tty* 

SEE ALSO 

stty(l). 

fork(2), ioctl(2), setpgrp(2), signal(2) in the Programmer's Reference Manual, 
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NAME 

timod - Transport Interface cooperating STREAMS module 
DESCRIPTION 

timod is a STREAMS module for use with the Transport Interface (TI) func- 
tions of the Network Services library. The timod module converts a set of 
ioctl{2) calls into STREAMS messages that may be consumed by a transport 
protocol provider which supports the Transport Interface. This allows a 
user to initiate certain TI functions as atomic operations. 

The timod module must only be pushed (see Streams Primer) onto a stream 
terminated by a transport protocol provider which supports the TI. 

All STREAMS messages, with the exception of the message types generated 
from the ioctl commands described below, will be transparently passed to 
the neighboring STREAMS module or driver. The messages generated from 
the following ioctl commands are recognized and processed by the timod 
module. The format of the ioctl call is: 

#include <sys/stropts.h> 



struct strioctl strioctl; 



strioctl.ic_cmd = cmd; 
strioctl.ic—timeout = INFTIM; 
strioctl. ic_len = size; 
strioctl.ic_dp = (char *)huf 

ioctl(fildes, I_STR, &strioctl); 

where, on issuance, size is the size of the appropriate TI message to be sent 
to the transport provider and on return, size is the size of the appropriate TI 
message from the transport provider in response to the issued TI message. 
buf is a pointer to a buffer large enough to hold the contents of the 
appropriate TI messages. The TI message types are defined in 
<sys/tihdr.h>. The possible values for the cmd field are: 

TL_BIND Bind an address to the underlying transport protocol pro- 

vider. The message issued to the TI_BIND ioctl is 
equivalent to the TI message type T_BIND_REQ and the 
message returned by the successful completion of the ioctl 
is equivalent to the TI message type T_BIND_ACK. 

TL-UNBIND Unbind an address from the underlying transport protocol 
provider. The message issued to the TI_UNBIND ioctl is 
equivalent to the TI message type T_UNBIND_REQ and the 
message returned by the successful completion of the ioctl 
is equivalent to the TI message type T_OK_-ACK. 

TLGETINFO Get the TI protocol specific information from the transport 
protocol provider. The message issued to the TI_GETINFO 
ioctl is equivalent to the TI message type T_INFO_REQ and 
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the message returned by the successful completion of the 
ioctl is equivalent to the TI message type T_INFO_ACK. 

TI_OPTMGMT Get, set, or negotiate protocol specific options with the 
transport protocol provider. The message issued to the 
TI_OPTMGMT ioctl is equivalent to the TI message type 
T_OPTMGMT_REQ, and the message returned by the suc- 
cessful completion of the ioctl is equivalent to the TI mes- 
sage type T_OPTMGMT_ACK. 

FILES 

<sys/timod.h> 
<sys/tiuser.h> 
<sys/tihdr.h> 
<sys/errno.h> 

SEE ALSO 

tirdwr(7). 
STREAMS Primer. 
STREAMS Programmer's Guide. 
Network Programmer's Guide. 

DIAGNOSTICS 

If the ioctl system call returns with a value greater than 0, the lower 8 bits 
of the return value will be one of the TI error codes as defined in 
<sys/tiuser.h>. If the TI error is of type TSYSERR, then the next 8 bits of 
the return value will contain an error as defined in <sys/errno.h> [see 
intro{2)]. 
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NAME 

tirdwr - Transport Interface read/ write interface STREAMS module 
DESCRIPTION 

tirdwr is a STREAMS module that provides an alternate interface to a tran- 
sport provider which supports the Transport Interface (TI) functions of the 
Network Services library (see Section 3N). This alternate interface allows a 
user to communicate with the transport protocol provider using the read{l) 
and write{2) system calls. The putmsg{2) and getmsg{2) system calls may 
also be used. However, putmsg and getmsg can only transfer data messages 
between user and stream. 

The tirdwr module must only be pushed [see LJPUSH in streamio{7)] onto a 
stream terminated by a transport protocol provider which supports the TI. 
After the tirdwr module has been pushed onto a stream, none of the Tran- 
sport Interface functions can be used. Subsequent calls to TI functions will 
cause an error on the stream. Once the error is detected, subsequent system 
calls on the stream will return an error with errno set to EPROTO. 

The following are the actions taken by the tirdwr module when pushed on 
the stream, popped [see L_POP in streamio{7)] off the stream, or when data 
passes through it. 

push - When the module is pushed onto a stream, it will check any 
existing data destined for the user to ensure that only regular 
data messages are present. It will ignore any messages on the 
stream that relate to process management, such as messages that 
generate signals to the user processes associated with the stream. 
If any other messages are present, the LJPUSH will return an 
error with errno set to EPROTO. 

write - The module will take the following actions on data that ori- 
ginated from a write system call: 

- All messages with the exception of messages that contain 
control portions (see the putmsg and getmsg system calls) will 
be transparently passed onto the module's downstream 
neighbor. 

- Any zero length data messages will be freed by the module 
and they will not be passed onto the module's downstream 
neighbor. 

- Any messages with control portions will generate an error, 
and any further system calls associated with the stream will 
fail with errno set to EPROTO. 

read - The module will take the following actions on data that ori- 
ginated from the transport protocol provider: 

- All messages with the exception of those that contain control 
portions (see the putmsg and getmsg system calls) will be tran- 
sparently passed onto the module's upstream neighbor. 
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- The action taken on messages with control portions will be as 
follows: 



+ Messages that represent expedited data will generate an 
error. All further system calls associated with the stream 
will fail with errno set to EPROTO. 

+ Any data messages with control portions will have the 
control portions removed from the message prior to 
passing the message to the upstream neighbor. 

+ Messages that represent an orderly release indication 
from the transport provider will generate a zero length 
data message, indicating the end of file, which will be 
sent to the reader of the stream. The orderly release 
message itself will be freed by the module. 

+ Messages that represent an abortive disconnect indica- 
tion from the transport provider will cause all further 
write and putmsg system calls to fail with errno set to 
ENXIO. All further read and getmsg system calls will 
return zero length data (indicating end of file) once all 
previous data has been read. 

+ With the exception of the above rules, all other mes- 
sages with control portions will generate an error and 
all further system calls associated with the stream will 
fail with errno set to EPROTO. 



- Any zero length data messages will be freed by the module 
and they will not be passed onto the module's upstream 
neighbor. 

pop - When the module is popped off the stream or the stream is 
closed, the module will take the following action: 

- If an orderly release indication has been previously received, 
then an orderly release request will be sent to the remote side 
of the transport connection. 

SEE ALSO 

streamio(7), timod(7). 

intro(2), getmsg(2), putmsg(2), read(2), write(2), intro(3) in the Programmer's 

Reference Manual. 

STREAMS Primer. 

STREAMS Programmer's Guide. 

Network Programmer's Guide. 
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NAME 

tty - controlling terminal interface 
DESCRIPTION 

The file /dev/tty is, in each process, a synonym for the control terminal 
associated with the process group of that process, if any. It is useful for 
programs or shell sequences that wish to be sure of writing messages on the 
terminal no matter how output has been redirected. It can also be used for 
programs that demand the name of a file for output, when typed output is 
desired and it is tiresome to find out what terminal is currently in use. 

FILES 

/dev/tty 
/dev/tty* 

SEE ALSO 

console(7). 
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NAME 

xt - multiplexed tty driver for AT&T windowing terminals 
DESCRIPTION 

The xt driver provides virtual tty(7) circuits multiplexed onto real tty(7) lines. 
It interposes its own channel multiplexing protocol as a line discipline 
between the real device driver and the standard tty (7) line disciplines. 

Virtual tty {7) circuits are named by character-special files of the form 
/dev/xt???. File names end in three digits, where the first two represent the 
channel group and the last represents the virtual tty (7) number (0-7) of the 
channel group. Allocation of a new channel group is done dynamically by 
attempting to open a name ending in with the 0_EXCL flag set. After a 
successful open, the tty(7) file onto which the channels are to be multi- 
plexed should be passed to xt via the XTIOCLINK ioctl{2) request. After- 
wards, all the channels in the group will behave as normal tty (7) files, with 
data passed in packets via the real tty (7) line. 

The xt driver implements the protocol described in xtproto{5) and in 
layers{5). Packets are formatted as described in xtproto{5), while the con- 
tents of packets conform to the description in layers{5). 

There are three groups of ioctl(2) requests recognized by xt. The first group 
contains all the normal tty ioctl(2) requests described in termio{7), with the 
addition of the following: 

TIOCEXCL Set exclusive use mode; no further opens are permitted 

until the file has been closed. 

TIOCNXCL Reset exclusive use mode; further opens are once again 

permitted. 

The second group of ioctl{2) requests concerns control of the windowing 
terminal, and is described in the header file <sys/jioctl.h>. The requests 
are as follows: 

JTYPE, JMPX Both return the value JMPX. These are used to identify a 
terminal device as an xt channel. 

JBOOT, JTERM Both generate an appropriate command packet to the 
windowing terminal affecting the layer associated with 
the file descriptor argument to ioctl{2.). They may return 
the error code EIO if the system clist is empty. 

JTIMO, JTIMOM JTIMO specifies the timeouts in seconds, and JTIMOM in 
milliseconds. Invalid except on channel 0. They may 
return the error code EIO if the system clist is empty. 

JWINSIZE Requires the address of a jwinsize structure as an argu- 

ment. The window sizes of the layer associated with the 
file descriptor argument to focf/(2) are copied to the 
structure. 

JZOMBOOT Generate a command packet to the windowing terminal 

to enter download mode on the channel associated with 
the file descriptor argument to ioctl(2), like JBOOT; but 
when the download is finished, make the layer a zombie 
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(ready for debugging). It may return the error code EIO 
if the system clist is empty. 

JAGENT Send the supplied data as a command packet to invoke a 

windowing terminal agent routine, and return the 
terminal's response to the calling process. Invalid except 
on the file descriptor for channel 0. See jagent(5). It 
may return the error code EIO if the system clist is 
empty. 

The third group of ioctl(2) requests concerns the configuration of xt, and is 
described in the header file <sys/xt.h>. The requests are as follows: 



XTIOCTYPE 
XTIOCLINK 



HXTIOCLINK 



XTIOCTRACE 



Returns the value XTIOCTYPE. 

Requires an argument that is a structure, xtioclm, contain- 
ing a file descriptor for the file to be multiplexed and the 
maximum number of channels allowed. Invalid except 
on channel 0. This request may return one of the follow- 
ing errors: 

EINVAL nchans has an illegal value. 

ENOTTY fd does not describe a real tty{7) device. 

ENXIO linesw is not configured with xt. 

EBUSY An XTIOCLINK request has already been 
issued for the channel group. 

ENOMEM There is no system memory available for allo- 
cating to the tty{7) structures. 

EIO The JTIMOM packet described above could 

not be delivered. 

Like XTIOCLINK, but specifies that ENCODING MODE be 
used. 



Requires the address of a tbuf structure as an argument. 
The structure is filled with the contents of the driver 
trace buffer. Tracing is enabled. This request is invalid if 
tracing is not configured. 

XTIOCNOTRACE Tracing is disabled. This request is invalid if tracing is 
not configured. 

XTIOCSTATS Requires an argument that is the address of an array of 
size S_NSTATS, of type Stats^t. The array is filled with 
the contents of the driver statistics array. This request is 
invalid if statistics are not configured. 

XTIOCDATA Requires the address of a maximum-sized Link structure 
as an argument. The structure is filled with the contents 
of the driver Link data. This request is invalid if data 
extraction is not configured. 
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FILES 

/dev/xt/??[0-7] multiplexed special files 

/usr/include/sys/jioctl.h packet command types 

/usr/include/sys/xtproto.h channel multiplexing protocol definitions 

/usr/include/sys/xt.h driver specific definitions 

SEE ALSO 

layers(l), termio(7), tty(7). 

ioctl(2), open(2), libwindows(3X), jagent(5), layers(5) in the Programmer's 
Reference Manual, 



PERMUTED INDEX 



a XENIX package, custom : install specific portions of custom(lM) 

functions of DASI 300 and/ 300, 300s: handle special 300(1) 

/special functions of DASI 300 and 300s terminals 300(1) 

of DASI 300 and 300s/ 300, 300s: handle special functions 300(1) 

functions of DASI 300 and 300s terminals, /special 300(1) 

comparison. diff3: 3-way differential file diff3(l) 

TEKTRONIX 4014 terminal. 4014: paginator for the 4014(1) 

paginator for the TEKTRONIX 4014 terminal. 4014: 4014(1) 

of the DASI 450 terminal. 450: handle special functions 450(1) 

special functions of the DASI 450 terminal. 450: handle 450(1) 

object downloader for the 5620 DMD terminal, wtinit: wtinit(lM) 

prevent LP requests, accept, reject: allow or accept(lM) 

a directory for remote access, adv: advertise adv(lM) 

settime: change a files access and modification dates settime(l) 

of a file, touch: update access and modification times touch(l) 

disk: random access bulk storage medium disk(7) 

f usage: disk access profiler fusage(lM) 

sulogin: access single-user mode sulogin(lM) 

copy file systems for optimal access time, dcopy: dcopy(lM) 

acctcon2: connect-time accounting, /acctconl, acctcon(lM) 

acctprcl, acctprc2: process accounting, acctprc: acctprc(lM) 

tumacct: shell procedures for accounting, /startup, acctsh(lM) 

/accton, acctwtmp: overview of accounting and miscellaneous/ acct(lM) 

accounting and miscellaneous accounting commands, /of acct(lM) 

diskusg: generate disk accounting data by user ID diskusg(lM) 

search and print process accounting file(s). acctcom: acctcom(l) 

acctmerg: merge or add total accounting files acctmerg(lM) 

summary from per-process accounting records, /command acctcms(lM) 

wtmpfix: manipulate connect accounting records, fwtmp, fwtmp(lM) 

runacct: run daily accounting runacct(lM) 

accton, acctwtmp: overview of/ acct: acctdisk, acctdusg, acct(lM) 

per-process accounting/ acctcms: command summary from acctcms(lM) 

process accounting file(s). acctcom: search and print acctcom(l) 

connect-time accounting, acctcon: acctconl, acctcon2: acctcon(lM) 

connect-time/ acctcon: acctconl, acctcon2: acctcon(lM) 

acctcon: acctconl, acctcon2: connect-time/ acctcon(lM) 

acctwtmp: overview of/ acct: acctdisk, acctdusg, accton, acct(lM) 

overview of/ acct: acctdisk, acctdusg, accton, acctwtmp: acct(lM) 

accounting files, acctmerg: merge or add total acctmerg(lM) 

acct: acctdisk, acctdusg, accton, acctwtmp: overview of/ acct(lM) 

process accounting, acctprc: acctprcl, acctprc2: acctprc(lM) 

accounting, acctprc: acctprcl, acctprc2: process acctprc(lM) 

acctprc: acctprcl, acctprc2: process accounting acctprc(lM) 

dodisk, lastlogin, monacct,/ acctsh: chargefee, ckpacct, acctsh(lM) 

acctdisk, acctdusg, accton, acctwtmp: overview of/ acct: acct(lM) 

killall: kill all active processes killall(lM) 

sag: system activity graph sag(lG) 

sar: sal, sa2, sadc: system activity report package sar(lM) 

sar: system activity reporter sar(l) 

report process data and system activity, /time a command; timex(l) 

device driver/ idinstall: add, delete, update, or get idinstall(lM) 
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acctmerg: merge or add total accounting files acctmerg(lM) 

new user, adduser: create a login for a adduser(l) 

the LP print/ Ipfilter: administer filters used with Iprilter(lM) 

LP print service. Ipforms: administer forms used with the Ipforms(lM) 

network listener service administration, nlsadmin: nlsadmin(lM) 

rfadmin: Remote File Sharing administration rfadmin(lM) 

uadmin: administrative control uadmin(lM) 

swap: swap administrative interface swap(lM) 

remote access, adv: advertise a directory for adv(lM) 

remote access, adv: advertise a directory for adv(lM) 

fumount: forced unmount of an advertised resource fumount(lM) 

accept, reject: allow or prevent LP requests accept(lM) 

sort: sort and/or merge files sort(l) 

introduction to commands and application programs, intro: intro(l) 

language, be: arbitrary-precision arithmetic bc(l) 

tar: file archiver tar(l) 

cpio: copy file archives in and out cpio(l) 

command, xargs: construct argument list(s) and execute xargs(l) 

expr: evaluate arguments as an expression expr(l) 

echo: echo arguments echo(l) 

be: arbitrary-precision arithmetic language bc(l) 

expr: evaluate arguments as an expression expr(l) 

asy: asynchronous serial port asy(7) 

asy: asynchronous serial port asy(7) 

a later time, at, batch: execute commands at at(l) 

xt: multiplexed tty driver for AT&T windowing terminals xt(7) 

tunable parameter, idtune: attempts to set value of a idtune(lM) 

login password and password attributes, passwd: change passwd(l) 

login password and password attributes, passwd: change passwd(lM) 

wait: await completion of process wait(l) 

processing language, awk: pattern scanning and awk(l) 

backup: performs backup functions backup(lM) 

functions, backup: performs backup backup(lM) 

banner: make posters banner(l) 

join: relational data base operator join(l) 

or query terminfo data base, /initialize a terminal tput(l) 

(visual) display editor based on ex. /screen-oriented vi(l) 

portions of path names, basename, dimame: deliver basename(l) 

later time, at, batch: execute commands at a at(l) 

arithmetic language, be: arbitrary-precision bc(l) 

initialization/ brc, bcheckrc: system brc(lM) 

bdiff: big diff bdiff(l) 

bfs: big file scanner bfs(l) 

sum: print checksum and block count of a file sum(l) 

sync: update the super block sync(lM) 

df: report number of free disk blocks and inodes df(lM) 

boot: UNIX system boot program boot(lM) 

program, boot: UNIX system boot boot(lM) 

initialization procedures, brc, bcheckrc: system brc(lM) 

idbuild: build new UNIX system kernel idbuild(lM) 

mknod: build special file mknod(lM) 

disk: random access bulk storage medium disk(7) 

cal: print calendar cal(l) 
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dc: desk calculator dc(l) 

cal: print calendar cal(l) 

calendar: reminder service calendar(l) 

cu: call another UNIX system cu(lC) 

request, rumount: cancel queued remote resource rumount(lM) 

to an LP print service. Ip, cancel: send/cancel requests lp(l) 

description into a terminfo/ captoinfo: convert a termcap captoinfo(lM) 

streamer interface, qt: QIC cartridge magnetic tape qt(7) 

text editor (variant of ex for casual users), edit: edit(l) 

files, cat: concatenate and print cat(l) 

cd: change working directory cd(l) 

conversion/ chrtbl: generate character classification and chrtbl(lM) 

fgrep: search a file for a character string fgrep(l) 

tr: translate characters tr(l) 

lastlogin, monacct,/ acctsh: chargefee, ckpacct, dodisk, acctsh(lM) 

fsck, dfsck: check and repair file systems fsck(lM) 

filesystems. xfsck: check and repair XENIX xfsck(lM) 

permissions file, uucheck: check the uucp directories and uucheck(lM) 

grpck: password/group file checkers, pwck, pwck(lM) 

file, sum: print checksum and block count of a sum(l) 

chown, chgrp: change owner or group chown(l) 

chmod: change mode chmod(l) 

group, chown, chgrp: change owner or chown(l) 

for a command, chroot: change root directory chroot(lM) 

classification and conversion/ chrtbl: generate character chrtbl(lM) 

monacct,/ acctsh: chargefee, ckpacct, dodisk, lastlogin, acctsh(lM) 

chrtbl: generate character classification and conversion/ chrtbl(lM) 

strclean: STREAMS error logger cleanup program strclean(lM) 

uucp spool directory clean-up. uucleanup: uucleanup(lM) 

clear: clear terminal screen clear(l) 

clri: clear inode clri(lM) 

clear: clear terminal screen clear(l) 

command interpreter that uses C-like syntax, /invoke a shell csh(l) 

cron: clock daemon cron(lM) 

rtc: real time clock interface ri:c(7) 

on a STREAMS driver, clone: open any minor device clone(7) 

clri: clear inode clri(lM) 

cram: CMOS RAM interface cram(7) 

cmp: compare two files cmp(l) 

line-feeds, col: filter reverse col(l) 

common to two sorted files, comm: select or reject lines comm(l) 

nice: run a command at low priority nice(l) 

change root directory for a command, chroot: chroot(lM) 

env: set environment for command execution env(l) 

UNIX system to UNIX system command execution, uux: uux(lC) 

quits, nohup: run a command immune to hangups and nohup(l) 

C-like/ csh: invoke a shell command interpreter that uses csh(l) 

getopt: parse command options getopt(l) 

getopts, getoptcvt: parse command options getopts(l) 

/shell, the standard/restricted command programming language sh(l) 

and system/ timex: time a command; report process data timex(l) 

uuxqt: execute remote command requests uuxqt(lM) 

per-process/ acctcms: command summary from acctcms(lM) 
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test: condition evaluation command test(l) 

time: time a command time(l) 

argument list(s) and execute command, xargs: construct xargs(l) 

and miscellaneous accounting commands, /of accounting acct(lM) 

intro: introduction to commands and application/ intro(l) 

at, batch: execute commands at a later time at(l) 

install: install commands install(lM) 

multiuser/ rc2: run commands performed for rc2(lM) 

operating system. rcO: run commands performed to stop the rcO(lM) 

streamio: STREAMS ioctl commands streamio(7) 

comm: select or reject lines common to two sorted files comm(l) 

ipcs: report inter-process communication facilities/ ipcs(l) 

diff: differential file comparator diff(l) 

descriptions, infocmp: compare or print out terminfo infocmp(lM) 

cmp: compare two files cmp(l) 

diff 3: 3 -way differential file comparison diff3(l) 

dircmp: directory comparison dircmp{l) 

tic: terminfo compiler tic(lM) 

wait: await completion of process wait(l) 

pack, peat, unpack: compress and expand files pack(l) 

cat: concatenate and print files cat(l) 

test: condition evaluation command test(l) 

update, or get device driver configuration data, /delete, idinstall(lM) 

service. Ipadmin: configure the LP print • Ipadmin(lM) 

fwtmp, wtmpfix: manipulate connect accounting records fwtmp(lM) 

acctcon: acctconl, acctcon2: connect-time accounting acctcon(lM) 

console: console interface console(7) 

display: system console display display(7) 

console: console interface console(7) 

keyboard: system console keyboard keyboard(7) 

mkfs: construct a file system mkfs(lM) 

execute command, xargs: construct argument list(s) and xargs(l) 

nroff/troff, tbl, and eqn constructs, deroff: remove deroff(l) 

debugging on. Uutry: try to contact remote system with Uutry(lM) 

idmkinit: read files containing specifications idmkinit(lM) 

Is, Ic: list contents of directory ls(l) 

csplit: context split csplit(l) 

device, tapecntl: tape control for QIC-24/QIC-02 tape tapecntl(l) 

init, telinit: process control initialization init(lM) 

uadmin: administrative control uadmin(lM) 

uucp status inquiry and job control, uustat: uustat(lC) 

interface, tty: controlling terminal tty(7) 

units: conversion program units(l) 

character classification and conversion tables, /generate chrtbl(lM) 

into a terminfo/ captoinfo: convert a termcap description captoinfo(lM) 

dd: convert and copy a file dd(lM) 

timod: Transport Interface cooperating STREAMS module timod(7) 

dd: convert and copy a file dd(lM) 

copy: copy groups of files copy(l) 

cpio: copy file archives in and out cpio(l) 

access time, dcopy: copy file systems for optimal dcopy(lM) 

copy: copy groups of files copy(l) 

cp. In, mv: copy, link, or move files cp(l) 
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volcopy: make literal copy of file system volcopy(lM) 

uuname: UNIX-to-UNIX system copy, uucp, uulog, uucp(lC) 

system to UNIX system file copy, /uupick: public UNIX uuto(lC) 

mem, kmem: core memory mem(7) 

file permissions and/ fixperm: correct or initialize XENIX fixperm(lM) 

sum: print checksum and block count of a file sum(l) 

wc: word count wc(l) 

move files, cp. In, mv: copy, link, or cp{l) 

and out. cpio: copy file archives in cpio(l) 

• cram: CMOS RAM interface cram(7) 

crash: examine system images crash(lM) 

adduser: create a login for a new user adduser(l) 

partition table, fdisk: create or modify hard disk fdisk(lM) 

cron: clock daemon cron(lM) 

crontab: user crontab file crontab(l) 

cron tab: user crontab file crontab(l) 

pg: file perusal filter for CRTs pg(l) 

crypt: encode/decode crypt(l) 

interpreter that uses C-like/ csh: invoke a shell command csh(l) 

csplit: context split csplit(l) 

terminal, ct: spawn getty to a remote ct(lC) 

cu: call another UNIX system cu(lC) 

rename login entry to show current layer, relogin: relogin(lM) 

uname: print name of current UNIX system uname(l) 

spline: interpolate smooth curve spline(lG) 

portions of a XENIX package, custom : install specific custom(lM) 

of each line of a file, cut: cut out selected fields cut(l) 

each line of a file, cut: cut out selected fields of cut(l) 

cron: clock daemon cron(lM) 

rfudaemon: Remote File Sharing daemon process rfudaemon(lM) 

strerr: STREAMS error logger daemon strerr(lM) 

runacct: run daily accounting runacct(lM) 

/handle special functions of DASI 300 and 300s terminals 300(1) 

special functions of the DASI 450 terminal, /handle 450(1) 

/time a command; report process data and system activity timex(l) 

join: relational data base operator join(l) 

a terminal or query terminfo data base, tput: initialize tput(l) 

generate disk accounting data by user ID. diskusg: diskusg(lM) 

device driver configuration data, /delete, update, or get idinstall(lM) 

date: print and set the date date(l) 

date: print and set the date date(l) 

files access and modification dates, settime: change a settime(l) 

dc: desk calculator dc(l) 

optimal access time, dcopy: copy file systems for dcopy(lM) 

dd: convert and copy a file dd(lM) 

fsdb: file system debugger fsdb(lM) 

to contact remote system with debugging on. Uutry: try Uutry(lM) 

driver/ idinstall: add, delete, update, or get device idinstall(lM) 

names, basename, dimame: deliver portions of path basename(l) 

the system, deluser: remove a login from deluser(l) 

mesg: permit or deny messages mesg(l) 

tbl, and eqn constructs, deroff: remove nroff/troff, deroff(l) 

description into a terminfo description, /a termcap captoinfo(lM) 
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captoinfo: convert a termcap description into a tenninfo/ captoinfo(lM) 

compare or print out terminfo descriptions, infocmp: infocmp(lM) 

dc: desk calculator dc(l) 

identifier, fstyp: detennine file system fstyp(lM) 

file: determine file type file(l) 

/add, delete, update, or get device driver configuration/ idinstall(lM) 

devnm: device name devnm(lM) 

clone: open any minor device on a STREAMS driver clone(7) 

control for QIC-24/QIC-02 tape device, tapecntl: tape tapecntl(l) 

devnm: device name devnm(lM) 

blocks and inodes. df: report number of free disk df(lM) 

systems, fsck, dfsck: check and repair file fsck(lM) 

bdiff:big diff bdiff(l) 

comparator, diff: differential file diff(l) 

comparison. diff3: 3-way differential file diff3(l) 

sdiff: side-by-side difference program sdiff(l) 

diff: differential file comparator diff(l) 

diffS: 3-way differential file comparison diff3(l) 

dircmp: directory comparison dircmp(l) 

file, uucheck: check the uucp directories and permissions uucheck(lM) 

link and unlink files and directories, link, unlink: link(lM) 

mkdir: make directories mkdir(l) 

rm, rmdir: remove files or directories 

cd: change working directory 

uucleanup: uucp spool directory clean-up uucleanup(lM) 

dircmp: directory comparison dircmp(l) 

chroot: change root directory for a command chroot(lM) 

adv: advertise a directory for remote access adv(lM) 

Is, Ic: list contents of directory ls(l) 

mvdir: move a directory . mvdir(lM) 

pwd: working directory name pwd(l) 

restore file to original directory, restore: restore(lM) 

path names, basename, dimame: deliver portions of basename(l) 

printers, enable, disable: enable/disable LP enable(l) 

type, modes, speed, and line discipline, /set terminal getty(lM) 

type, modes, speed, and line discipline, /set terminal uugetty(lM) 

fusage: disk access profiler fusage(lM) 

ID. diskusg: generate disk accounting data by user diskusg(lM) 

df: report number of free disk blocks and inodes df(lM) 

fd: diskette (floppy disk) fd(7) 

hd: hard (fixed) disk hd(7) 

mkpart: disk maintenance utility mkpart(lM) 

fdisk: create or modify hard disk partition table fdisk(lM) 

diskadd: disk partitioning utility diskadd(lM) 

storage medium, disk: random access bulk disk(7) 

format: format floppy disk tracks format(lM) 

du: summarize disk usage du(lM) 

utility, diskadd: disk partitioning diskadd(lM) 

fd: diskette (floppy disk) fd(7) 

accounting data by user ID. diskusg: generate disk diskusg(lM) 

display: system console display display(7) 

/screen-oriented (visual) display editor based on ex vi(l) 

format, hd: display files in hexadecimal hd(l) 
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displaypkg: display installed packages displaypkg(l) 

information, rmntstat: display mounted resource rmntstat(lM) 

display, display: system console display(7) 

file, tail: display the last part of a tail(l) 

packages, displaypkg: display installed displaypkg(l) 

object downloader for the 5620 DMD terminal, wtinit: wtinit(lM) 

Sharing domain and network/ dname: Print Remote File dname(lM) 

acctsh: chargefee, ckpacct, dodisk, lastlogin, monacct,/ acctsh(lM) 

whodo: who is doing what whodo(lM) 

/Print Remote File Sharing domain and network names dname(lM) 

terminal, wtinit: object downloader for the 5620 DMD wtinit(lM) 

graph: draw a graph graph(lG) 

any minor device on a STREAMS driver, clone: open clone(7) 

/delete, update, or get device driver configuration data idinstall(lM) 

xt: multiplexed tty driver for AT&T windowing/ xt(7) 

xtd: extract and print xt driver link structure xtd(lM) 

xtt: extract and print xt driver packet traces xtt(lM) 

xts: extract and print xt driver statistics xts(lM) 

sxt: pseudo-device driver sxt(7) 

du: summarize disk usage du(lM) 

od: octal dump od(l) 

echo: echo arguments echo(l) 

echo: echo arguments echo(l) 

ed, red: text editor ed(l) 

ex for casual users), edit: text editor (variant of edit(l) 

/(visual) display editor based on ex vi(l) 

ed, red: text editor ed(l) 

ex: text editor ex(l) 

sed: stream editor sed(l) 

casual users), edit: text editor (variant of ex for edit(l) 

pattern using full regular/ egrep: search a file for a egrep(l) 

enable/disable LP printers, enable, disable: enable(l) 

enable, disable: enable/disable LP printers enable(l) 

crypt: encode/decode crypt(l) 

makekey: generate encryption key makekey(l) 

relogin: rename login entry to show current layer relogin(lM) 

command execution, env: set environment for env(l) 

execution, env: set environment for command env(l) 

performed for multiuser environment, /run commands rc2(lM) 

stop the Remote File Sharing environment, rfstop: rfstop(lM) 

remove nroff/troff, tbl, and eqn constructs, deroff: deroff(l) 

strclean: STREAMS error logger cleanup program strclean(lM) 

strerr: STREAMS error logger daemon strerr(lM) 

log: interface to STREAMS error logging and event/ log(7) 

hashcheck: find spelling errors, /hashmake, spellin, spell(l) 

setmnt: establish mount table setmnt(lM) 

expression, expr: evaluate arguments as an expr(l) 

test: condition evaluation command test(l) 

to STREAMS error logging and event tracing, log: interface log(7) 

edit: text editor (variant of ex for casual users) edit(l) 

ex: text editor ex(l) 

display editor based on ex. /screen-oriented (visual) vi(l) 

crash: examine system images crash(lM) 
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construct argument list(s) and execute command, xargs: xargs(l) 

time, at, batch: execute commands at a later at(l) 

requests, uuxqt: execute remote command uuxqt(lM) 

set environment for command execution, env: env(l) 

sleep: suspend execution for an interval sleep(l) 

system to UNIX system command execution, uux: UNIX uux(lC) 

peat, unpack: compress and expand files, pack, pack(l) 

expression, expr: evaluate arguments as an expr(l) 

expr: evaluate arguments as an expression expr(l) 

a pattern using full regular expressions, /a file for egrep(l) 

link structure, xtd: extract and print xt driver xtd(lM) 

packet traces, xtt: extract and print xt driver xtt(lM) 

statistics, xts: extract and print xt driver xts(lM) 

factors of a number, factor: obtain the prime factor(l) 

factor: obtain the prime factors of a number factor(l) 

true, false: provide truth values true(l) 

fd: diskette (floppy disk) fd(7) 

disk partition table, fdisk: create or modify hard fdisk(lM) 

statistics for a file system, ff: list file names and ff(lM) 

character string, fgrep: search a file for a fgrep(l) 

tar: file archiver tar(l) 

cpio: copy file archives in and out cpio(l) 

pwck, grpck: password/group file checkers pwck(lM) 

diff: differential file comparator diff(l) 

diff3: 3-way differential file comparison diff3(l) 

UNIX system to UNIX system file copy, /uupick: public uuto(lC) 

crontab: user crontab file crontab(l) 

fields of each line of a file, cut: cut out selected cut(l) 

dd: convert and copy a file dd(lM) 

file: determine file type file(l) 

fgrep: search a file for a character string fgrep(l) 

grep: search a file for a pattern grep(l) 

regular/ egrep: search a file for a pattern using full egrep(l) 

split: split a file into pieces split(l) 

mknod: build special file mknod(lM) 

a file system, ff: list file names and statistics for ff(lM) 

change the format of a text file, newform: nev^form(l) 

null: the null file null(7) 

time, more: view a file one full screen at a more(l) 

/identify processes using a file or file structure fuser(lM) 

or subsequent lines of one file, /lines of several files paste(l) 

correct or initialize XENIX file permissions and/ fixperm: fixperm(lM) 

pg: file perusal filter for CRTs pg(l) 

bfs: big file scanner bfs(l) 

rfadmin: Remote File Sharing administration rfadmin(lM) 

rfudaemon: Remote File Sharing daemon process rfudaemon(lM) 

network/ dname: Print Remote File Sharing domain and dname(lM) 

rfstop: stop the Remote File Sharing environment rfstop(lM) 

rfpassvy^d: change Remote File Sharing host password rfpasswd(lM) 

query, nsquery: Remote File Sharing name server nsquery(lM) 

shell/ rfuadmin: Remote File Sharing notification rfuadmin(lM) 

unadv: unadvertise a Remote File Sharing resource unadv(lM) 

/mount, unmount Remote File Sharing resources rmountall(lM) 
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rfstart: start Remote File Sharing rfstart(lM) 

mapping, idload: Remote File Sharing user and group idload(lM) 

printable strings in an object file, strings: find the strings(l) 

processes using a file or file structure, /identify fuser(lM) 

checksum and block count of a file, sum: print sum(l) 

fsdb: file system debugger fsdb{lM) 

names and statistics for a file system, ff: list file ff(lM) 

fstyp: determine file system identifier fstyp(lM) 

mkfs: construct a file system mkfs(lM) 

fsstat: report file system status fsstat{lM) 

volcopy: make literal copy of file system volcopy(lM) 

/umount: mount and unmount file systems and remote/ mount(lM) 

access time, dcopy: copy file systems for optimal dcopy(lM) 

fsck, dfsck: check and repair file systems fsck(lM) 

labelit: provide labels for file systems labelit(lM) 

mount, unmount multiple file systems, /umountall: mountall(lM) 

display the last part of a file, tail: tail(l) 

restore: restore file to original directory restore(lM) 

and modification times of a file, touch: update access touch(l) 

uucp system, uucico: file transport program for the uucico(lM) 

/the scheduler for the uucp file transport program uusched(lM) 

file: determine file type file(l) 

report repeated lines in a file, uniq: uniq(l) 

directories and permissions file, uucheck: check the uucp uucheck(lM) 

umask: set file-creation mode mask umask(l) 

dates, settime: change a files access and modification settime(l) 

and print process accounting file(s). acctcom: search acctcom(l) 

merge or add total accounting files, acctmerg: acctmerg(lM) 

link, unlink: link and unlink files and directories link(lM) 

cat: concatenate and print files cat(l) 

cmp: compare two files cmp(l) 

lines common to two sorted files, comm: select or reject comm(l) 

idmkinit: read files containing/ idmkinit(lM) 

copy: copy groups of files copy(l) 

In, mv: copy, link, or move files, cp, cp(l) 

find: find files find(l) 

hd: display files in hexadecimal format hd(l) 

intro: introduction to special files intro(7) 

passmgmt: password files management passmgmt(lM) 

rm, rmdir: remove files or directories nTi(l) 

/merge same lines of several files or subsequent lines of/ paste(l) 

unpack: compress and expand files, pack, peat, pack(l) 

pr: print files pr(l) 

sort: sort and/or merge files sort(l) 

invoke XENIX incremental filesystem restorer, /xrestor: xrestore(lM) 

xfsck: check and repair XENIX filesystems xfsck(lM) 

pg: file perusal filter for CRTs Pg(l) 

greek: select terminal filter greek(l) 

nl: line-numbering filter nl(l) 

col: filter reverse line-feeds col(l) 

tplot: graphics filters tplot(lG) 

service. Ipfilter: administer filters used with the LP print Ipfilter(lM) 

find: find files find(l) 
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find: find files find(l) 

hashmake, spellin, hashcheck: find spelling errors, spell, spell(l) 

an object file, strings: find the printable strings in strings(l) 

tee: pipe fitting tee(l) 

hd:hard (fixed) disk hd(7) 

XENIX file permissions and/ fixperm: correct or initialize fixperm(lM) 

fd: diskette (floppy disk) fd(7) 

format: format floppy disk tracks format(lM) 

advertised resource, fumount: forced unmount of an fumount(lM) 

format: format floppy disk tracks format(lM) 

tracks, format: format floppy disk format(lM) 

display files in hexadecimal format, hd: hd(l) 

newform: change the format of a text file newform(l) 

service. Ipforms: administer forms used with the LP print Ipforms(lM) 

df: report number of free disk blocks and inodes df(lM) 

idspace: investigates free space idspace(lM) 

ncheck: generate path names from i-numbers ncheck(lM) 

acctcms: command summary from per-process accounting/ acctcms(lM) 

deluser: remove a login from the system deluser(l) 

file systems, fsck, dfsck: check and repair fsck(lM) 

fsdb: file system debugger fsdb(lM) 

status, fsstat: report file system fsstat(lM) 

identifier, fstyp: determine file system fstyp(lM) 

/a file for a pattern using full regular expressions egrep(l) 

more: view a file one full screen at a time more(l) 

advertised resource, fumount: forced unmount of an fumount(lM) 

backup: performs backup functions backup(lM) 

300, 300s: handle special functions of DASI 300 and 300s/ 300(1) 

terminals, hp: handle special functions of Hewlett-Packard hp(l) 

terminal. 450: handle special functions of the DASI 450 450(1) 

fusage: disk access profiler fusage(lM) 

using a file or file/ fuser: identify processes fuser(lM) 

connect accounting records, fwtmp, wtmpfix: manipulate fwtmp(lM) 

random: generate a random number random(l) 

classification and/ chrtbl: generate character chrtbl(lM) 

by user ID. diskusg: generate disk accounting data diskusg(lM) 

makekey: generate encryption key makekey(l) 

i-numbers. ncheck: generate path names from ncheck(lM) 

add, delete, update, or get device driver/ idinstall: idinstall(lM) 

logname: get login name logname(l) 

value, machid: 1386: get processor type truth machid(l) 

tty: get the name of the terminal tty(l) 

getopt: parse command options getopt(l) 

options, getopts, getoptcvt: parse command getopts(l) 

command options, getopts, getoptcvt: parse getopts(l) 

modes, speed, and line/ getty: set terminal type, getty(lM) 

ct: spawn getty to a remote terminal ct(lC) 

graph: draw a graph graph(lG) 

graph: draw a graph graph(lG) 

sag: system activity graph sag(lG) 

tplot: graphics filters tplot(lG) 

greek: select terminal filter greek(l) 

pattern, grep: search a file for a grep(l) 
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chown, chgrp: change owner or group chown(l) 

id: print user and group IDs and names id(lM) 

Remote File Sharing user and group mapping, idload: idload(lM) 

newgrp: log in to a new group newgrp(lM) 

copy: copy groups of files copy(l) 

checkers, pwck, grpck: password/group file pwck(lM) 

DASI 300 and 300s/ 300, 300s: handle special functions of 300(1) 

Hewlett-Packard/ hp: handle special functions of hp(l) 

the DASI 450 terminal. 450: handle special functions of 450(1) 

nohup: run a command immune to hangups and quits nohup(l) 

fdisk: create or modify hard disk partition table fdisk(lM) 

hd: hard (fixed) disk hd(7) 

spell, hashmake, spellin, hashcheck: find spelling/ spell(l) 

find spelling errors, spell, hashmake, spellin, hashcheck: spell(l) 

hexadecimal format, hd: display files in l^d(l) 

hd: hard (fixed) disk hd(7) 

/handle special functions of Hewlett-Packard terminals hp(l) 

hd: display files in hexadecimal format bd(l) 

change Remote File Sharing host password, rfpasswd: rfpasswd(lM) 

of Hewlett-Packard terminals, hp: handle special functions hp(l) 

value, machid: 1386: get processor type truth machid(l) 

disk accounting data by user ID. diskusg: generate diskusg(lM) 

set, or shared memory id. /message queue, semaphore ipcrm(l) 

and names, id: print user and group IDs id(lM) 

kernel, idbuild: build new UNIX system idbuild(lM) 

information, idcheck: returns selected idcheck(lM) 

fstyp: determine file system identifier fstyp(lM) 

file or file/ fuser: identify processes using a fuser(lM) 

update, or get device driver/ idinstall: add, delete, idinstall(lM) 

user and group mapping, idload: Remote File Sharing idload(lM) 

containing specifications, idmkinit: read files idmkinit(lM) 

reads specifications of/ idmknod: removes nodes and idmknod(lM) 

id: print user and group IDs and names id(lM) 

space, idspace: investigates free idspace(lM) 

of a tunable parameter, idtune: attempts to set value idtune(lM) 

crash: examine system images crash(lM) 

nohup: run a command immune to hangups and quits nohup(l) 

/xrestor: invoke XENIX incremental filesystem/ xrestore(lM) 

terminfo descriptions, infocmp: compare or print out infocmp(lM) 

initialization, init, telinit: process control init(lM) 

init, telinit: process control initialization init(lM) 

brc, bcheckrc: system initialization procedures brc(lM) 

terminfo data base, tput: initialize a terminal or query tput(l) 

fixperm: correct or initialize XENIX file/ fixperm(lM) 

clri: clear inode clri(lM) 

number of free disk blocks and inodes. df: report df(lM) 

uustat: uucp status inquiry and job control uustat(lC) 

pwconv: install and update pwconv(lM) 

install: install commands install(lM) 

install: install commands install(lM) 

installpkg: install package installpkg(l) 

xinstall: XENIX installation shell script xinstall(lM) 

removepkg: remove installed package removepkg(l) 
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displaypkg: display installed packages displaypkg(l) 

installpkg: install package installpkg(l) 

system, mailx: interactive message processing mailx(l) 

console: console interface console(7) 

module, timod: Transport Interface cooperating STREAMS timod(7) 

cram: CMOS RAM interface cram(7) 

Ip: parallel port interface lp(7) 

magnetic tape streamer interface, qt: QIC cartridge qt(7) 

STREAMS/ tirdwr: Transport Interface read/write interface tirdwr(7) 

rtc: real time clock interface rtc(7) 

/Transport Interface read/write interface STREAMS module tirdwr(7) 

swap: swap administrative interface swap(lM) 

termio: general terminal interface termio(7) 

logging and event/ log: interface to STREAMS error log(7) 

tty: controlling terminal interface tty(7) 

spline: interpolate smooth curve spline(lG) 

csh: invoke a shell command interpreter that uses C-like/ csh(l) 

facilities/ ipcs: report inter-process communication ipcs(l) 

suspend execution for an interval, sleep: sleep(l) 

commands and application/ intro: introduction to intro(l) 

files, intro: introduction to special intro(7) 

application programs, intro: introduction to commands and intro(l) 

intro: introduction to special files intro(7) 

generate path names from i-numbers. ncheck: ncheck(lM) 

idspace: investigates free space idspace(lM) 

interpreter that uses/ csh: invoke a shell command csh(l) 

filesystem/ xrestore, xrestor: invoke XENIX incremental xrestore(lM) 

streamio: STREAMS iocti commands streamio(7) 

semaphore set, or shared/ ipcrm: remove a message queue, ipcrm(l) 

communication facilities/ ipcs: report inter-process ipcs(l) 

terminal state, ismpx: return windowing ismpx(l) 

news: print news items news(l) 

operator, join: relational data base join(l) 

windowing terminal, jterm: reset layer of jterm(l) 

jwin: print size of layer jwin(l) 

idbuild: build new UNIX system kernel idbuild(lM) 

makekey: generate encryption key makekey{l) 

keyboard: system console keyboard keyboard{7) 

keyboard, keyboard: system console keyboard(7) 

killall: kill all active processes killall(lM) 

kill: terminate a process kill(l) 

processes, killall: kill all active killall(lM) 

mem, kmem: core memory mem(7) 

file systems, labelit: provide labels for labelit(lM) 

labelit: provide labels for file systems labelit(lM) 

scanning and processing language, awk: pattern awk(l) 

arbitrary-precision arithmetic language, be: bc(l) 

scanning and processing language, nawk: pattern nawk(l) 

command programming language, /standard/restricted sh(l) 

/chargefee, ckpacct, dodisk, lasdogin, monacct, nulladm,/ acctsh(lM) 

jwin: print size of layer jwin(l) 

shl: shell layer manager shl(l) 

windowing terminals, layers: layer multiplexer for layers(l) 
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jterm: reset layer of windowing terminal jterm(l) 

login entry to show current layer, relogin: rename relogin(lM) 

windowing terminals, layers: layer multiplexer for layers(l) 

directory. Is, Ic: list contents of ls(l) 

type, modes, speed, and line discipline, /set terminal getty(lM) 

type, modes, speed, and line discipline, /set terminal uugetty(lM) 

line: read one line line(l) 

out selected fields of each line of a file, cut: cut cut(l) 

line: read one line line(l) 

col: filter reverse line-feeds col(l) 

nl: line-numbering filter nl(l) 

files, comm: select or reject lines common to two sorted comm(l) 

uniq: report repeated lines in a file uniq(l) 

of several files or subsequent lines of one file, /same lines paste(l) 

subsequent/ paste: merge same lines of several files or paste(l) 

directories, link, unlink: link and unlink files and link(lM) 

cp, In, mv: copy, link, or move files cp(l) 

extract and print xt driver link structure, xtd: xtd(lM) 

files and directories, link, unlink: link and unlink link(lM) 

Is, Ic: list contents of directory ls(l) 

for a file system, ff: list file names and statistics ff(lM) 

nlsadmin: network listener service/ nlsadmin(lM) 

xargs: construct argument list(s) and execute command xargs(l) 

volcopy: make literal copy of file system volcopy(lM) 

files, cp. In, mv: copy, link, or move cp(l) 

newgrp: log in to a new group newgrp(lM) 

error logging and event/ log: interface to STREAMS log(7) 

strclean: STREAMS error logger cleanup program strclean(lM) 

strerr: STREAMS error logger daemon strerr{lM) 

/interface to STREAMS error logging and event tracing log(7) 

layer, relogin: rename login entry to show current relogin(lM) 

adduser: create a login for a new user adduser(l) 

deluser: remove a login from the system deluser(l) 

logname: get login name logname(l) 

attributes, passwd: change login password and password passwd(l) 

attributes, passwd: change login password and password passwd(lM) 

login: sign on login(l) 

logname: get login name logname(l) 

nice: run a command at low priority nice(l) 

requests to an LP print/ Ip, cancel: send/cancel lp(l) 

Ip: parallel port interface lp(7) 

/Ipshut, Ipmove: start/stop the LP print service and move/ Ipsched(lM) 

send/cancel requests to an LP print service. Ip, cancel: lp(l) 

Ipadmin: configure the LP print service Ipadmin(lM) 

filters used with the LP print service, /administer Ipfilter(lM) 

administer forms used with the LP print service. Ipforms: Ipforms(lM) 

information about status of LP print service, /print Ipstat(l) 

disable: enable/disable LP printers, enable, enable(l) 

reject: allow or prevent LP requests, accept, accept(lM) 

print service. Ipadmin: configure the LP Ipadmin(lM) 

used with the LP print/ Ipfilter: administer filters Ipfilter(lM) 

with the LP print service. Ipforms: administer forms used Ipforms(lM) 

print/ Ipsched, Ipshut, Ipmove: start/stop the LP Ipsched(lM) 
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start/stop the LP print/ Ipsched, Ipshut, Ipmove: Ipsched(lM) 

LP print service and/ Ipsched, Ipshut, Ipmove: start/stop the Ipsched(lM) 

about status of LP print/ Ipstat: print information Ipstat(l) 

priorities. Ipusers: set printing queue Ipusers(lM) 

directory. Is, Ic: list contents of ls(l) 

type truth value, machid: 1386: get processor machid(l) 

interface, qt: QIC cartridge magnetic tape streamer qt(7) 

send mail to users or read mail, mail, rmail: mail(l) 

users or read mail, mail, rmail: send mail to mail(l) 

mail, rmail: send mail to users or read mail mail(l) 

processing system, mailx: interactive message mailx(l) 

mkpart: disk maintenance utility mkpart(lM) 

mkdir: make directories mkdir(l) 

system, volcopy: make literal copy of file volcopy(lM) 

banner: make posters banner(l) 

key. makekey: generate encryption makekey(l) 

passmgmt: password files management passmgmt(lM) 

shl: shell layer manager shl(l) 

records, fwtmp, wtmpfix: manipulate connect accounting fwtmp(lM) 

File Sharing user and group mapping, idload: Remote idload(lM) 

umask: set file-creation mode mask umask(l) 

random access bulk storage medium, disk: disk(7) 

mem, kmem: core memory mem(7) 

semaphore set, or shared memory id. /a message queue, ipcrm(l) 

mem, kmem: core memory mem(7) 

sort: sort and/or merge files sort(l) 

files, acctmerg: merge or add total accounting acctmerg(lM) 

files or subsequent/ paste: merge same lines of several paste(l) 

mesg: permit or deny messages niesg(l) 

mailx: interactive message processing system mailx(l) 

or shared/ ipcrm: remove a message queue, semaphore set, ipcrm(l) 

mesg: permit or deny messages mesg(l) 

strace: print STREAMS trace messages strace(lM) 

driver, clone: open any minor device on a STREAMS clone(7) 

mkdir: make directories mkdir(l) 

mkfs: construct a file system mkfs(lM) 

mknod: build special file mknod(lM) 

utility, mkpart: disk maintenance mkpart(lM) 

chmod: change mode chmod(l) 

umask: set file-creation mode mask umask(l) 

sulogin: access single-user mode sulogin(lM) 

getty: set terminal type, modes, speed, and line/ getty(lM) 

uugetty: set terminal type, modes, speed, and line/ uugetty(lM) 

information to set tenninal modes, tset: provide tset(l) 

change a files access and modification dates, settime: settime(l) 

touch: update access and modification times of a file touch(l) 

table, fdisk: create or modify hard disk partition fdisk(lM) 

Interface cooperating STREAMS module, timod: Transport timod(7) 

read/write interface STREAMS module. /Transport Interface tirdwr(7) 

/ckpacct, dodisk, lastlogin, monacct, nulladm, prctmp,/ acctsh(lM) 

and remote/ mount, umount: mount and unmount file systems mount(lM) 

setmnt: establish mount table setmnt(lM) 

unmount file systems and/ mount, umount: mount and mount(lM) 
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systems, mountall, umountall: mount, unmount multiple file mountall(lM) 

rmountall, rumountall: mount, unmount Remote File/ rmountall(lM) 

unmount multiple file/ mountall, umountall: mount, mountall(lM) 

rmntstat: display mounted resource information rmntstat(lM) 

rmount: retry remote resource mounts rmount(lM) 

mvdir: move a directory mvdir(lM) 

cp. In, mv: copy, link, or move files cp(l) 

the LP print service and move requests, /start/stop Ipsched(lM) 

/umountall: mount, unmount multiple file systems mountall(lM) 

AT&T windowing terminals, xt: multiplexed tty driver for xt(7) 

terminals, layers: layer multiplexer for windowing layers(l) 

run commands performed for multiuser environment. rc2: rc2(lM) 

cp. In, mv: copy, link, or move files cp(l) 

mvdir: move a directory mvdir(lM) 

processing language, nawk: pattern scanning and nawk(l) 

from i-numbers. ncheck: generate path names ncheck(lM) 

administration, nlsadmin: network listener service nlsadmin(lM) 

Remote File Sharing domain and network names, dname: Print dname(lM) 

a text file, newform: change the format of newform(l) 

newgrp: log in to a new group newgrp(lM) 

news: print news items news(l) 

news: print news items news(l) 

priority, nice: run a command at low nice(l) 

nl: line-numbering filter nl(l) 

service administration, nlsadmin: network listener nlsadmin(lM) 

of nodes, idmknod: removes nodes and reads specifications idmknod(lM) 

and reads specifications of nodes, idmknod: removes nodes idmknod(lM) 

hangups and quits, nohup: run a command immune to nohup(l) 

rfuadmin: Remote File Sharing notification shell script rfuadmin(lM) 

constructs, deroff: remove nroff/troff, tbl, and eqn deroff(l) 

name server query, nsquery: Remote File Sharing nsquery(lM) 

null: the null file null(7) 

null: the null file null(7) 

/dodisk, lastlogin, monacct, nuUadm, prctmp, prdaily,/ acctsh(lM) 

DMD terminal, wtinit: object downloader for the 5620 wtinit(lM) 

the printable strings in an object file, strings: find strings(l) 

number, factor: obtain the prime factors of a factor(l) 

od: octal dump od(l) 

od: octal dump od(l) 

STREAMS driver, clone: open any minor device on a clone(7) 

prf: operating system profiler prf(7) 

commands performed to stop the operating system. rcO: run rcO(lM) 

join: relational data base operator joiri(l) 

dcopy: copy file systems for optimal access time dcopy(lM) 

stty: set the options for a terminal stty(l) 

getopt: parse command options getopt(l) 

getoptcvt: parse command options, getopts, getopts(l) 

restore: restore file to original directory restore(lM) 

parameters, sysdef: output values of tunable sysdef(lM) 

/acctdusg, accton, acctwtmp: overview of accounting and/ acct(lM) 

chown, chgrp: change owner or group chown(l) 

XENIX file permissions and ownership, /or initialize fixperm(lM) 

and expand files, pack, peat, unpack: compress pack(l) 
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specific portions of a XENIX package, custom : install custom(lM) 

installpkg: install package installpkg(l) 

removepkg: remove installed package removepkg(l) 

sadc: system activity report package, sar: sal, sa2, sar(lM) 

displaypkg: display installed packages displaypkg(l) 

extract and print xt driver packet traces, xtt: xtt(lM) 

4014 terminal. 4014: paginator for the TEKTRONIX 4014(1) 

Ip: parallel port interface lp(7) 

to set value of a tunable parameter, idtune: attempts idtune(lM) 

output values of tunable parameters, sysdef: sysdef(lM) 

getopt: parse command options getopt(l) 

getopts, getoptcvt: parse command options getopts(l) 

create or modify hard disk partition table, fdisk: fdisk(lM) 

diskadd: disk partitioning utility diskadd(lM) 

management, passmgmt: password files passmgmt(lM) 

and password attributes, passwd: change login password passwd(l) 

and password attributes, passwd: change login password passwd(lM) 

passwd: change login password and password/ passwd(l) 

passwd: change login password and password/ passwd(lM) 

change login password and password attributes, passwd: passwd(l) 

change login password and password attributes, passwd: passwd(lM) 

passmgmt: password files management passmgmt(lM) 

Remote File Sharing host password, rfpasswd: change rfpasswd(lM) 

pwck, grpck: password/group file checkers pwck(lM) 

several files or subsequent/ paste: merge same lines of paste(l) 

dimame: deliver portions of path names, basename, basename(l) 

ncheck: generate path names from i-numbers ncheck(lM) 

grep: search a file for a pattern grep(l) 

processing language, awk: pattern scanning and awk(l) 

processing language, nawk: pattern scanning and nawk(l) 

egrep: search a file for a pattern using full regular/ egrep(l) 

expand files, pack, peat, unpack: compress and pack(l) 

rc2: run commands performed for multiuser/ rc2(lM) 

operating/ rcO: run commands performed to stop the rcO(lM) 

backup: performs backup functions backup(lM) 

/or initialize XENIX file permissions and ownership fixperm(lM) 

check the uucp directories and permissions file, uucheck: uucheck(lM) 

mesg: permit or deny messages mesg(l) 

acctcms: command summary from per-process accounting/ acctcms(lM) 

pg: file perusal filter for CRTs pg(i) 

CRTs, pg: file perusal filter for pg(i) 

split: split a file into pieces split(l) 

tee: pipe fitdng tee(l) 

asy: asynchronous serial port asy(7) 

Ip: parallel port interface lp(7) 

custom : install specific portions of a XENIX package custom(lM) 

basename, dimame: deliver portions of path names basename(l) 

banner: make posters banner(l) 

pr: print files pr(i) 

/lasdogin, monacct, nulladm, prctmp, prdaily, prtacct,/ acctsh(lM) 

/monacct, nulladm, prctmp, prdaily, prtacct, runacct,/ acctsh(lM) 

accept, reject: allow or prevent LP requests accept(lM) 

profiler, prf: operating system prf(7) 
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profiler: prfld, prfstat, prfdc, prfsnap, prfpr: UNIX/ profiler(lM) 

prfsnap, prfpr:/ profiler: prfld, prfstat, prfdc, profiler(lM) 

/prfstat, prfdc, prfsnap, prfpr: UNIX system profiler profiler(lM) 

/prfld, prfstat, prfdc, prfsnap, prfpr: UNIX system/ profiler(lM) 

prfpr: UNIX/ profiler: prfld, prfstat, prfdc, prfsnap, profiler(lM) 

factor: obtain the prime factors of a number factor(l) 

date: print and set the date date(l) 

cal: print calendar cal(l) 

of a file, sum: print checksum and block count sum(l) 

cat: concatenate and print files cat(l) 

pr: print files pr(l) 

of LP print service. Ipstat: print information about status Ipstat(l) 

system, uname: print name of current UNIX uname(l) 

news: print news items news(l) 

infocmp: compare or print out terminfo/ infocmp(lM) 

file(s). acctcom: search and print process accounting acctcom(l) 

domain and network/ dname: Print Remote File Sharing dname(lM) 

/Ipmove: start/stop the LP print service and move/ Ipsched(lM) 

send/cancel requests to an LP print service. Ip, cancel: lp(l) 

Ipadmin: configure the LP print service Ipadmin(lM) 

filters used with the LP print service, /administer Ipfilter(lM) 

forms used with the LP print service, /administer Ipforms(lM) 

information about status of LP print service. Ipstat: print Ipstat(l) 

jwin: print size of layer jwin(l) 

strace: print STREAMS trace messages strace(lM) 

yes: repeatedly print string yes(l) 

names, id: print user and group IDs and id(lM) 

structure, xtd: extract and print xt driver link xtd(lM) 

xtt: extract and print xt driver packet traces xtt(lM) 

xts: extract and print xt driver statistics xts(lM) 

file, strings: find the printable strings in an object strings(l) 

disable: enable/disable LP printers, enable, enable(l) 

Ipusers: set printing queue priorities Ipusers(lM) 

Ipusers: set printing queue priorities Ipusers(lM) 

nice: run a command at low priority nice(l) 

acctprc: acctprcl, acctprc2: process accounting acctprc(lM) 

acctcom: search and print process accounting file(s) acctcom(l) 

init, telinit: process control/ init(lM) 

timex: time a command; report process data and system/ timex(l) 

kill: terminate a process kill(l) 

Remote File Sharing daemon process, rfudaemon: rfudaemon(lM) 

ps: report process status ps(l) 

wait: await completion of process wait(l) 

killall: kill all active processes killall(lM) 

structure, fuser: identify processes using a file or file fuser(lM) 

awk: pattern scanning and processing language awk(l) 

nawk: pattern scanning and processing language nawk(l) 

mailx: interactive message processing system mailx(l) 

machid: i386: get processor type truth value machid(l) 

fusage: disk access profiler fusage(lM) 

prf: operating system profiler prf(7) 

prfdc, prfsnap, prfpr: UNIX/ profiler: prfld, prfstat, profiler(lM) 

prfsnap, prfpr: UNIX system profiler, /prfstat, prfdc, profiler(lM) 
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standard/restricted command programming language, /the sh(l) 

terminal modes, tset: provide information to set tset(l) 

systems, labelit: provide labels for file labelit(lM) 

true, false: provide truth values true(l) 

/nulladm, prctmp, prdaily, prtacct, runacct, shutacct,/ acctsh(lM) 

ps: report process status ps(l) 

sxt: pseudo-device driver sxt(7) 

file checkers, pwck, grpck: password/group pwck(lM) 

pwconv: install and update pwconv(lM) 

pwd: working directory name pwd(l) 

streamer interface, qt: QIC cartridge magnetic tape qt(7) 

tapecntl: tape control for QIC-24/QIC-02 tape device tapecntl(l) 

tape streamer interface, qt: QIC cartridge magnetic qt(7) 

File Sharing name server query, nsquery: Remote nsquery(lM) 

tput: initialize a terminal or query terminfo data base tput(l) 

Ipusers: set printing queue priorities Ipusers(lM) 

ipcrm: remove a message queue, semaphore set, or/ ipcrm(l) 

request, rumount: cancel queued remote resource rumount(lM) 

command immune to hangups and quits, nohup: run a nohup(l) 

cram: CMOS RAM interface cram(7) 

medium, disk: random access bulk storage disk(7) 

number, random: generate a random random(l) 

random: generate a random number random(l) 

stop the operating system. rcO: run commands performed to rcO(lM) 

for multiuser environment. rc2: run commands performed rc2(lM) 

specifications, idmkinit: read files containing idmkinit(lM) 

rmail: send mail to users or read mail, mail, mail(l) 

line: read one line line(l) 

idmknod: removes nodes and reads specifications of nodes idmknod(lM) 

tirdwr: Transport Interface read/write interface STREAMS/ tirdwr(7) 

from per-process accounting records, /command summary acctcms(lM) 

manipulate connect accounting records, fwtmp, wtmpfix: fwtmp(lM) 

ed, red: text editor ed(l) 

file for a pattern using full regular expressions, /search a egrep(l) 

requests, accept, reject: allow or prevent LP accept(lM) 

sorted files, comm: select or reject lines common to two comm(l) 

join: relational data base operator join(l) 

show current layer, relogin: rename login entry to relogin(lM) 

calendar: reminder service calendar(l) 

adv: advertise a directory for remote access adv(lM) 

uuxqt: execute remote command requests uuxqt(lM) 

administration, rfadmin: Remote File Sharing rfadmin(lM) 

process, rfudaemon: Remote File Sharing daemon rfudaemon(lM) 

network names, dname: Print Remote File Sharing domain and dname(lM) 

environment, rfstop: stop the Remote File Sharing rfstop(lM) 

password, rfpasswd: change Remote File Sharing host rfpasswd(lM) 

server query, nsquery: Remote File Sharing name nsquery(lM) 

notification shell/ rfuadmin: Remote File Sharing rfuadmin(lM) 

unadv: unadvertise a Remote File Sharing resource unadv(lM) 

/rumountall: mount, unmount Remote File Sharing resources rmountall(lM) 

rf start: start Remote File Sharing rfstart(lM) 

group mapping, idload: Remote File Sharing user and idload(lM) 

rmount: retry remote resource mounts rmount(lM) 
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rumount: cancel queued 


remote resource request 




and unmount file systems and 


remote resources, /mount 




on. Uutry: try to contact 


remote system with debugging .... 


. . UutrvHM^ 


ct: spawn getty to a 




. . . ctflO 


system, deluser: 


remove a login from the 




semaphore set, or/ ipcrm: 


remove a message queue, 




rm, rmdir: 


remove files or directories .... 




removepkg: 


remove installed package . . . 




eqn constructs, deroff: 


remove nroff/troff, tbl, and 


. . . . deroff(l) 


package. 






specifications of/ idmknod: 


removes nodes and reads 




current layer, relogin: 


rename login entry to show 




fsck, dfsck: check and 


repair file systems 


fcrkn 


xfsck: check and 


repair XENIX filesystems 




uniq: report 


repeated lines in a file 


• . • uniq(l) 


yes: 


repeatedly print string 




fsstat: 


report file system status 




communication/ ipcs: 


report inter-process 




blocks and inodes. df: 


report number of free disk 




sa2, sadc: system activity 


renort narksiyp qat' qsI 

1 ^k^^l L L/ClV-^d^C DCII . OCt 1 , ...... 


. . . . sar^iMj 


timex: time a command; 


report process data and system/ 


fimov/ 1 ^ 


DS: 


report process status 




file, uniq: 


report repeated lines in a 




sar: system activity 


reporter 




cancel queued remote resource 


request, rumount" 


1 TVi r^i 1 T% f / 1 \A\ 


reject: allow or prevent LP 


requests, accept, 




the LP print service and move 


requests. /Ipmove: start/stop .... 


InsrhpHn M\ 


Ip, cancel: send/cancel 


requests to an LP print/ . . . 




uuxqt: execute remote command 






terminal, jterm: 


reset layer of windowing . . . 




unmount of an advertised 


resource, fumount: forced 


. • fumount(lM) 


rmntstat: display mounted 


resource information 




rmount: retry remote 


resource mounts 




rumount: cancel queued remote 


resource request 




a Remote File Sharing 


resource, unadv: unadvertise 




file systems and remote 


resources /mount and unmount 




unmount Remote File Sharing 


resources /rumountall' mount 


f»TYi/^i 1 iifrfal 1/ 1 \A\ 


directory, restore: 


restore file to original 


focf/^ro^ 1 \A\ 


original directory. 


restore* restore file to 


t"ocf 1 \A\ 


ti vTil 1 ICll IllCdy^ldll 






1 11 ll-rLll 1 L. 






State, ismpx: 


return windowing terminal 




idcheck: 


returns selected information 




col: filter 


reverse line-feeds 


. . . . col(l) 


administration. 






Sharing host password. 


rfpasswd: change Remote File .... 




Sharing. 






Sharing environment. 


rfstop: stop the Remote File , 




notification shell script. 


rfuadmin: Remote File Sharing . . . . , 




daemon process. 


rfudaemon: Remote File Sharing . . . , 




directories. 


rm, rmdir: remove files or 


. . . . rm(l) 


read mail, mail. 


rmail: send mail to users or 


. . . . mail(l) 


directories, rm. 
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resource information, rmntstat: display mounted rmntstat(lM) 

mounts, rmount: retry remote resource rmount(lM) 

unmount Remote File Sharing/ rmountall, rumountall: mount, rmountall(lM) 

chroot: change root directory for a command chroot(lM) 

standard/restricted/ sh, rsh: shell, the sh(l) 

interface, rtc: real time clock rtc(7) 

resource request, rumount: cancel queued remote rumount(lM) 

Remote File/ rmountall, rumountall: mount, unmount rmountall(lM) 

nice: run a command at low priority nice(l) 

hangups and quits, nohup: run a command immune to nohup(l) 

multiuser environment. rc2: run commands performed for rc2(lM) 

the operating system. rcO: run commands performed to stop rcO(lM) 

runacct: run daily accounting runacct(lM) 

runacct: run daily accounting runacct(lM) 

/prctmp, prdaily, prtacct, runacct, shutacct, startup,/ acctsh(lM) 

activity report package, sar: sal, sa2, sadc: system sar(lM) 

report package, sar: sal, sa2, sadc: system activity sar(lM) 

package, sar: sal, sa2, sadc: system activity report sar(lM) 

sag: system activity graph sag(lG) 

activity report package, sar: sal, sa2, sadc: system sar(lM) 

sar: system activity reporter sar(l) 

bfs: big file scanner bfs(l) 

language, awk: pattern scanning and processing awk(l) 

language, nawk: pattern scanning and processing nawk(l) 

transport/ uusched: the scheduler for the uucp file uusched(lM) 

more: view a file one full screen at a time more(l) 

clear: clear terminal screen clear(l) 

display/ vi, view, vedit: screen-oriented (visual) vi(l) 

Sharing notification shell script, rfuadmin: Remote File rfuadmin(lM) 

XENIX installation shell script, xinstall: xinstall(lM) 

program, sdiff: side-by-side difference sdiff(l) 

string, fgrep: search a file for a character fgrep(l) 

grep: search a file for a pattern grep(l) 

using full regular/ egrep: search a file for a pattern egrep(l) 

accounting file(s). acctcom: search and print process acctcom(l) 

sed: stream editor sed(l) 

to two sorted files, comm: select or reject lines common comm(l) 

greek: select terminal filter greek(l) 

of a file, cut: cut out selected fields of each line cut(l) 

idcheck: returns selected information idcheck(lM) 

ipcrm: remove a message queue, semaphore set, or shared/ ipcrm(l) 

mail, mail, rmail: send mail to users or read mail(l) 

print service. Ip, cancel: send/cancel requests to an LP lp(l) 

asy: asynchronous serial port asy(7) 

Remote File Sharing name server query, nsquery: nsquery(lM) 

/a message queue, semaphore set, or shared memory id ipcrm(l) 

setmnt: establish mount table setmnt(lM) 

and modification dates, settime: change a files access settime(l) 

standard/restricted command/ sh, rsh: shell, the sh(l) 

queue, semaphore set, or shared memory id. /a message ipcrm(l) 

rfadmin: Remote File Sharing administration rfadmin(lM) 

rfudaemon: Remote File Sharing daemon process rfudaemon(lM) 

dname: Print Remote File Sharing domain and network/ dname(lM) 
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rfstop: stop the Remote File Sharing environment rfstop(lM) 

rfpasswd: change Remote File Sharing host password rfpasswd(lM) 

nsquery: Remote File Sharing name server query nsquery(lM) 

script, rfuadmin: Remote File Sharing notification shell rfuadmin(lM) 

unadvertise a Remote File Sharing resource, unadv: unadv(lM) 

/mount, unmount Remote File Sharing resources rmountall(lM) 

rf start: start Remote File Sharing rfstart(lM) 

mapping, idload: Remote File Sharing user and group idload(lM) 

uses C-like/ csh: invoke a shell command interpreter that csh(l) 

shl: shell layer manager shl(l) 

shutacct, startup, tumacct: shell procedures for/ /runacct, acctsh(lM) 

File Sharing notification shell script. /Remote rfuadmin(lM) 

xinstall: XENIX installation shell script xinstall(lM) 

command programming/ sh, rsh: shell, the standard/restricted sh(l) 

shl: shell layer manager shl(l) 

system state, shutdown: shut down system, change shutdown(lM) 

/prdaily, prtacct, runacct, shutacct, startup, tumacct:/ acctsh(lM) 

change system state, shutdown: shut down system, shutdown(lM) 

program, sdiff: side-by-side difference sdiff(l) 

login: sign on login(l) 

sulogin: access single-user mode sulogin(lM) 

jwin: print size of layer jwin(l) 

an interval, sleep: suspend execution for sleep(l) 

spline: interpolate smooth curve spline(lG) 

sort: sort and/or merge files sort(l) 

sort: sort and/or merge files sort(l) 

or reject lines common to two sorted files, comm: select comm(l) 

idspace: investigates free space idspace(lM) 

terminal, ct: spawn getty to a remote ct(lC) 

package, custom : install specific portions of a XENIX custom(lM) 

read files containing specifications, idmkinit: idmkinit(lM) 

/removes nodes and reads specifications of nodes idmknod(lM) 

/set terminal type, modes, speed, and line discipline getty(lM) 

/set terminal type, modes, speed, and line discipline uugetty(lM) 

hashcheck: find spelling/ spell, hashmake, spellin, spell(l) 

spelling/ spell, hashmake, spellin, hashcheck: find spell(l) 

spellin, hashcheck: find spelling errors, /hashmake, spell(l) 

curve, spline: interpolate smooth spline(lG) 

split: split a file into pieces split(l) 

csplit: context split csplit(l) 

pieces, split: split a file into split(l) 

uucleanup: uucp spool directory clean-up uucleanup(lM) 

sh, rsh: shell, the standard/restricted command/ sh(l) 

rfstart: start Remote File Sharing rfstart(lM) 

Ipsched, Ipshut, Ipmove: start/stop the LP print/ Ipsched(lM) 

/prtacct, runacct, shutacct, startup, tumacct: shell/ acctsh(lM) 

ff: list file names and statistics for a file system ff(lM) 

extract and print xt driver statistics, xts: xts(lM) 

fsstat: report file system status fsstat(lM) 

control, uustat: uucp status inquiry and job uustat(lC) 

communication facilities status, /report inter-process ipcs(l) 

/print information about status of LP print service Ipstat(l) 

ps: report process status ps(l) 
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rcO: run commands performed to stop the operating system rcO(lM) 

environment, rfstop: stop the Remote File Sharing rfstop(lM) 

disk: random access bulk storage medium disk(7) 

messages, strace: print STREAMS trace strace(lM) 

cleanup program, strclean: STREAMS error logger strclean(lM) 

sed: stream editor sed(l) 

QIC cartridge magnetic tape streamer interface, qt: qt(7) 

commands, streamio: STREAMS ioctl streamio(7) 

open any minor device on a STREAMS driver, clone: clone(7) 

program, strclean: STREAMS error logger cleanup strclean(lM) 

strerr: STREAMS error logger daemon strerr(lM) 

event/ log: interface to STREAMS error logging and log(7) 

streamio: STREAMS ioctl commands streamio(7) 

Interface cooperating STREAMS module. /Transport timod(7) 

Interface read/write interface STREAMS module. /Transport tirdwr(7) 

strace: print STREAMS trace messages strace(lM) 

daemon, strerr: STREAMS error logger strerr(lM) 

search a file for a character string, fgrep: fgrep(l) 

yes: repeatedly print string yes(l) 

strings in an object file, strings: find the printable strings(l) 

strings: find the printable strings in an object file strings(l) 

processes using a file or file structure, fuser: identify fuser(lM) 

and print xt driver link structure, xtd: extract xtd(lM) 

terminal, stty: set the options for a stty(l) 

another user, su: become super-user or su(lM) 

/same lines of several files or subsequent lines of one file paste(l) 

mode, sulogin: access single-user sulogin(lM) 

count of a file, sum: print checksum and block sum(l) 

du: summarize disk usage du(lM) 

accounting/ acctcms: command summary from per-process acctcms(lM) 

sync: update the super block sync(lM) 

su: become super-user or another user su(lM) 

interval, sleep: suspend execution for an sleep(l) 

swap: swap administrative interface swap(lM) 

interface, swap: swap administrative swap(lM) 

sxt: pseudo-device driver sxt(7) 

sync: update the super block sync(lM) 

interpreter that uses C-like syntax, /a shell command csh(l) 

tunable parameters, sysdef: output values of sysdef(lM) 

shutdown: shut down system, change system state shutdown(lM) 

or modify hard disk partition table, fdisk: create fdisk(lM) 

setmnt: establish mount table setmnt(lM) 

classification and conversion tables, /generate character chrtbl(lM) 

tabs: set tabs on a terminal tabs(l) 

tabs: set tabs on a terminal tabs(l) 

a file, tail: display the last part of tail(l) 

tape device, tapecntl: tape control for QIC-24/QIC-02 tapecntl(l) 

tape control for QIC-24/QIC-02 tape device, tapecntl: tapecntl(l) 

qt: QIC cartridge magnetic tape streamer interface qt(7) 

QIC-24/QIC-02 tape device, tapecntl: tape control for tapecntl(l) 

tar: file archiver tar(l) 

deroff: remove nroff/troff, tbl, and eqn constructs deroff(l) 

tee: pipe fitting tee(l) 
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4014: paginator for the TEKTRONIX 4014 terminal 4014(1) 

initialization, init, telinit: process control init(lM) 

terminfo/ captoinfo: convert a termcap description into a captoinfo(lM) 

for the TEKTRONIX 4014 terminal. 4014: paginator 4014(1) 

functions of the DASI 450 terminal. 450: handle special 450(1) 

ct: spawn getty to a remote terminal ct(lC) 

greek: select terminal filter greek(l) 

termio: general terminal interface termio(7) 

tty: controlling terminal interface tty(7) 

reset layer of windowing terminal, jterm: jterm(l) 

provide information to set terminal modes, tset: tset(l) 

data base, tput: initialize a terminal or query terminfo tput(l) 

clear: clear terminal screen clear(l) 

ismpx: return windowing terminal state ismpx(l) 

stty: set the options for a terminal stty(l) 

tabs: set tabs on a terminal tabs(l) 

tty: get the name of the terminal tty(l) 

and line/ getty: set terminal type, modes, speed, getty(lM) 

and line/ uugetty: set terminal type, modes, speed, uugetty(lM) 

downloader for the 5620 DMD terminal, wtinit: object wtinit(lM) 

functions of DASI 300 and 300s terminals, /handle special 300(1) 

functions of Hewlett-Packard terminals, hp: handle special bp(l) 

multiplexer for windowing terminals, layers: layer layers(l) 

tty driver for AT&T windowing terminals, xt: multiplexed xt(7) 

kill: terminate a process kill(l) 

tic: terminfo compiler tic(lM) 

initialize a terminal or query terminfo data base, tput: tput(l) 

a termcap description into a terminfo description, /convert captoinfo(lM) 

infocmp: compare or print out terminfo descriptions infocmp(lM) 

interface, termio: general terminal termio(7) 

command, test: condition evaluation test(l) 

ed, red: text editor ed(l) 

ex: text editor ex(l) 

casual users), edit: text editor (variant of ex for edit(l) 

change the format of a text file, newform: newform(l) 

tic: terminfo compiler tic(lM) 

data and system/ timex: time a command; report process timex(l) 

time: time a command time(l) 

execute commands at a later time, at, batch: at(l) 

rtc: real time clock interface rtc(7) 

systems for optimal access time, dcopy: copy file dcopy(lM) 

a file one full screen at a time, more: view more(l) 

time: time a command time(l) 

update access and modification times of a file, touch: touch(l) 

process data and system/ timex: time a command; report timex(l) 

cooperating STREAMS module, timod: Transport Interface timod(7) 

read/write interface STREAMS/ tirdwr: Transport Interface tirdwr(7) 

acctmerg: merge or add total accounting files acctmerg(lM) 

modification times of a file, touch: update access and touch(l) 

tplot: graphics filters tplot(lG) 

query terminfo data base, tput: initialize a terminal or tput(l) 

tr: translate characters tr(l) 

strace: print STREAMS trace messages strace(lM) 
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and print xt driver packet traces, xtt: extract xtt(lM) 

error logging and event tracing, /interface to STREAMS log(7) 

format: format floppy disk tracks format(lM) 

tr: translate characters tr(l) 

cooperating STREAMS/ timod: Transport Interface timod(7) 

interface STREAMS/ tirdwr: Transport Interface read/ write tirdwr(7) 

system, uucico: file transport program for the uucp uucico(lM) 

scheduler for the uucp file transport program, /the uusched(lM) 

values, true, false: provide truth true(l) 

1386: get processor type truth value, machid: machid(l) 

true, false: provide truth values true(l) 

with debugging on. Uutry: try to contact remote system Uutry(lM) 

set terminal modes, tset: provide information to tset(l) 

interface, tty: controlling terminal tty(7) 

terminals, xt: multiplexed tty driver for AT&T windowing xt(7) 

terminal, tty: get the name of the tty(l) 

attempts to set value of a tunable parameter, idtune: idtune(lM) 

sysdef: output values of tunable parameters sysdef(lM) 

/runacct, shutacct, startup, tumacct: shell procedures for/ acctsh(lM) 

file: determine file type file(l) 

getty: set terminal type, modes, speed, and line/ getty(lM) 

uugetty: set terminal type, modes, speed, and line/ uugetty(lM) 

machid: 1386: get processor type truth value machid(l) 

control, uadmin: administrative uadmin(lM) 

mask, umask: set file-creation mode umask(l) 

systems and remote/ mount, umount: mount and unmount file mount(lM) 

multiple file/ mountall, umountall: mount, unmount mountall(lM) 

File Sharing resource, unadv: unadvertise a Remote unadv(lM) 

Sharing resource, unadv: unadvertise a Remote File unadv(lM) 

UNIX system, uname: print name of current uname(l) 

a file, uniq: report repeated lines in uniq(l) 

units: conversion program units(l) 

uucp, uulog, uuname: UNIX-to-UNIX system copy uucp(lC) 

link, unlink: link and unlink files and directories link(lM) 

and directories, link, unlink: link and unlink files link(lM) 

mount, umount: mount and unmount file systems and/ mount(lM) 

mountall, umountall: mount, unmount multiple file systems mountall(lM) 

resource, fumount: forced unmount of an advertised fumount(lM) 

rmountall, rumountall: mount, unmount Remote File Sharing/ rmountall(lM) 

files, pack, peat, unpack: compress and expand pack(l) 

times of a file, touch: update access and modification touch(l) 

idinstall: add, delete, update, or get device driver/ idinstall(lM) 

pwconv: install and update pwconv(lM) 

sync: update the super block sync(lM) 

du: summarize disk usage du(lM) 

create a login for a new user, adduser: adduser(l) 

id: print user and group IDs and names id(lM) 

idload: Remote File Sharing user and group mapping idload(lM) 

crontab: user crontab file crontab(l) 

disk accounting data by user ID. diskusg: generate diskusg(lM) 

become super-user or another user, su: su(lM) 

write: write to another user write(l) 

(variant of ex for casual users), edit: text editor edit(l) 
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mail, rmail: send mail to users or read mail mail(l) 

wall: write to all users wall(l) 

shell command interpreter that uses C-like syntax, /invoke a csh(l) 

fuser: identify processes using a file or file/ fuser(lM) 

search a file for a pattern using full regular/ egrep: egrep(l) 

diskadd: disk partitioning utility diskadd(lM) 

mkpart: disk maintenance utility mkpart(lM) 

directories and permissions/ uucheck: check the uucp uucheck(lM) 

for the uucp system, uucico: file transport program uudco(lM) 

directory clean-up. uucleanup: uucp spool uucleanup(lM) 

uucheck: check the uucp directories and/ uucheck(lM) 

uusched: the scheduler for the uucp file transport program uusched(lM) 

uucleanup: uucp spool directory clean-up uucleanup(lM) 

control, uustat: uucp status inquiry and job uustat(lC) 

file transport program for the uucp system, uucico: uucico(lM) 

UNIX-to-UNIX system copy, uucp, uulog, uuname: uucp(lC) 

modes, speed, and line/ uugetty: set terminal type, uugetty(lM) 

system copy, uucp, uulog, uuname: UNIX-to-UNIX uucp(lC) 

copy, uucp, uulog, uuname: UNIX-to-UNIX system uucp(lC) 

UNIX system file copy, uuto, uupick: public UNIX system to uuto(lC) 

uucp file transport program, uusched: the scheduler for the uusched(lM) 

and job control, uustat: uucp status inquiry uustat(lC) 

system to UNIX system file/ uuto, uupick: public UNIX uuto(lC) 

system with debugging on. Uutry: try to contact remote Uutry(lM) 

system command execution, uux: UNIX system to UNIX uux(lC) 

requests, uuxqt: execute remote command uuxqt(lM) 

i386: get processor type truth value, machid: machid(l) 

idtune: attempts to set value of a tunable parameter idtune(lM) 

sysdef: output values of tunable parameters sysdef(lM) 

true, false: provide truth values true(l) 

users), edit: text editor (variant of ex for casual edit(l) 

(visual) display/ vi, view, vedit: screen-oriented vi(l) 

screen-oriented (visual)/ vi, view, vedit: vi(l) 

a time, more: view a file one full screen at more(l) 

(visual) display editor/ vi, view, vedit: screen-oriented vi(l) 

/view, vedit: screen-oriented (visual) display editor based/ vi(l) 

file system, volcopy: make literal copy of volcopy(lM) 

process, wait: await completion of wait(l) 

wall: write to all users wall(l) 

wc: word count wc(l) 

whodo: who is doing what whodo(lM) 

who: who is on the system who(l) 

who: who is on the system who(l) 

whodo: who is doing what whodo(lM) 

jterm: reset layer of windowing terminal jterm(l) 

ismpx: return windowing terminal state ismpx(l) 

layers: layer multiplexer for windowing terminals layers(l) 

/tty driver for AT&T windowing terminals xt(7) 

cd: change working directory cd(l) 

pwd: working directory name pwd(l) 

wall: write to all users wall(l) 

write: write to another user write(l) 

write: write to another user write(l) 
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the 5620 DMD terminal, wtinit: object downloader for wtinit(lM) 

accounting records, fwtmp, wtmpfix: manipulate connect fwtmp(lM) 

list(s) and execute command, xargs: construct argument xargs(l) 

fixperm: correct or initialize XENIX file permissions and/ fixperm(lM) 

xfsck: check and repair XENIX filesystems xfsck(lM) 

xrestore, xrestor: invoke XENIX incremental filesystem/ xrestore(lM) 

script, xinstall: XENIX installation shell xinstall(lM) 

specific portions of a XENIX package. / install custom(lM) 

filesystems. xfsck: check and repair XENIX xfsck(lM) 

shell script, xinstall: XENIX installation xinstall(lM) 

incremental/ xrestore, xrestor: invoke XENIX xrestore(lM) 

XENIX incremental filesystem/ xrestore, xrestor: invoke xrestore(lM) 

xtd: extract and print xt driver link structure xtd(lM) 

xtt: extract and print xt driver packet traces xtt(lM) 

xts: extract and print xt driver statistics xts(lM) 

AT&T windowing terminals, xt: multiplexed tty driver for xt(7) 

driver link structure, xtd: extract and print xt xtd(lM) 

driver statistics, xts: extract and print xt xts(lM) 

driver packet traces, xtt: extract and print xt xtt(lM) 

yes: repeatedly print string yes(l) 
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24. UNIX* Sys. V User's Ref. 
Manual, AT&T 

25. UNIX* Sys. V User's Guide. 
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26. UNIX® Sys. V Utilities 
Release Notes, AT&T 

27. UNIX* Sys. V Sys. Admin. 
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28. UNIX* Sys. V Sys. Admin. 
Ref. Manual. AT&T 

29. The C Programming 
Language, 2/E. 
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Language, 1/E, 
Kernighan/Ritchie 

31. The C Answer Book, 2/E. 
Tondo/Gimpel 

32. The C Answer Book, 1/E, 
Tondo/Gimpel 

33. ANSI C: A Lexical Guide. 
Mark Williams Co. 

34. Doing Business with C, 
Swartz 

35. Advanced C Programming, 
Rochkind 

36. C Trainer, Feuer 

37. C: A Reference Manual, 
2/E, Harbison et al. 

38. C Companion, Holub 

39. Programming in C with a 
Bit of UNIX*, Moore 

40. Learning To Program in C, 
Plum 

41. C Notes, Zahn 

42. C Prog, in Berkeley UNIX* 
Envirmnt., Horspool 

43. C Prog.'s Handbook, Bolsky 

44. Crafting C Tools, Campbell 

45. C Puzzle Book, Feuer 

46. Numerical Software Tools 
in C, Kempf 

47. C Programming Guidelines, 
Plum 

48. A Software Tools Sampler, 
Miller 

49. Systems Software Tools, 
Biggerstaff 
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Mgt., Manis et al. 

51. UNIX* Prog. Envirmnt., 
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52. Advanced UNIX* Prog., 
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